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About This Guide 


This guide describes how to manage Linux POSIX volumes on a Novell Open Enterprise Server 
(OES) 11 Support Pack 3 (SP3) server by using the Novell Storage Services (NSS) Management 
Utility and the Novell Linux Volume Manager (NLVM) command line interface (CLI). 

* Chapter 1, "Overview of Linux POSIX File Systems,” on page 9 

* Chapter 2, "What's New or Changed for Linux POSIX Volumes,” on page 17 


* Chapter 3, "Installing or Upgrading NSS Management Tools and Linux POSIX File Systems," on 
page 25 


* Chapter 4, "Using NLVM and NSSMU in a Virtualized Environment," on page 27 

* Chapter 5, "Planning for Linux POSIX Volumes," on page 29 

* Chapter 6, "Managing Linux Volumes with NSSMU,” on page 33 

* Chapter 7, "Managing Linux Volumes with NLVM Commands," on page 59 

* Chapter 8, "Clustering LVM Volume Groups with Novell Cluster Services," on page 79 
* Chapter 9, "Backing Up Linux POSIX Volumes," on page 117 

* Appendix A, "Documentation Updates," on page 119 


Audience 


This guide is intended for storage and system administrators. 


Feedback 


We want to hear your comments and suggestions about this manual and the other documentation 
included with this product. Please use the User Comments feature at the bottom of each page of the 
online documentation. 


Documentation Updates 
For the most recent version of the Linux POSIX Volume Administration Guide, visit the OES 11 SP3 
website (http://www.novell.com/documentation/oes11/). 


Additional Documentation 


For information about the Novell Linux Volume Manager commands, see the OES 11 SP3: NLVM 
Reference. 


For information about managing the Novell Storage Services file system, see the OES 11 SP3: NSS 
File System Administration Guide for Linux. 


For information about clustering with Novell Cluster Services, see the OES 11 SP3: Novell Cluster 
Services for Linux Administration Guide. 
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For information about using the file system management tools that are native to SUSE Linux 
Enterprise Server (SLES) 11 Service Pack 4 (SP4), see the SLES 11 SP4 Storage Administration 
Guide (http://www.suse.com/documentation/sles11/stor_admin/data/bookinfo.html). The SLES guide 
describes Linux storage management technologies such as: 


* 


* 


* 


* 


Native Linux file systems (Btrfs, Ext2, Ext3, ReiserFS, and XFS) 
Logical Volume Manager (LVM) 

Multipath I/O (Device Mapper) 

Linux iSCSI initiators and targets and iSCSI LIO targets 

Internet Storage Name Service (iSNS) 

Fibre Channel over Ethernet 
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Overview of Linux POSIX File Systems 


SUSE Linux Enterprise Server (SLES) 11 Service Pack 4 (SP4) provides several native Linux POSIX 
file systems. Novell Open Enterprise Server (OES) 11 Support Pack 3 (SP3) allows you to use the 
Novell Storage Services (NSS) Management Utility (NSSMU) and the Novell Linux Volume Manager 
(NLVM) commands to create native Linux POSIX volumes and Linux Logical Volume Manager (LVM) 
volume groups and logical volumes on your OES servers. 


The NSSMU and NLVM tools also allow you to create cluster-enabled LVM volume groups and logical 
volumes on your Novell Cluster Services clusters. You can use the Clusters plug-in for Novell 
iManager and cluster commands to manage the resources. See Chapter 8, “Clustering LVM 
Volume Groups with Novell Cluster Services," on page 79. For information about Novell Cluster 
Services, see the OES 11 SP3: Novell Cluster Services for Linux Administration Guide. 


The Linux features of these NSS tools support the Btrfs, Ext2, Ext3, ReiserFS, and XFS file systems. 
Each file system has its own advantages and disadvantages. This section describes key features of 
the supported native Linux POSIX file systems, including access control, availability, scalability, and 
speed. You can use this information to help determine which of these file systems best fits your 
storage needs. For a side-by-side comparison of the technical features of native Linux file systems, 
see "File System Support" on the SUSE Linux Enterprise Server Technical Information website (http:/ 
/www.suse.com/products/server/technical-information/#FileSystem). 

« Section 1.1, “Btrfs,” on page 9 

« Section 1.2, "Ext2," on page 11 

« Section 1.3, "Ext3," on page 11 

« Section 1.4, "ReiserFS," on page 13 

+ Section 1.5, “XFS,” on page 14 

« Section 1.6, "What's Next," on page 15 


For information about managing the NSS file system on your OES servers, see the OES 11 SP3: 
NSS File System Administration Guide for Linux. 


Btrfs 


The Btrfs file system is a copy-on-write (COW) file system based on COW-friendly B-trees. It provides 
fault tolerance, repair, and easy management features, such as the following: 


* Writable snapshots that allow you to easily roll back your system if needed after applying 
updates, or to back up files. 

* Compression to efficiently use storage space. 

* Different RAID levels for metadata and user data. 

* Different checksums for metadata and user data to improve error detection. 

* Integration with Linux Logical Volume Manager (LVM) storage objects. 

* Integration with the YaST 2 Partitioner and AutoYaST on SUSE Linux. 
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+ Offline, in-place migration from existing Ext2, Ext3, and Ext4 file systems. 


+ Btrfs quota support for subvolumes, such as the Birfs root file system subvolumes /var/log, / 
var/crash, and /var/cache. 


For more information, see "Btrfs" (http://www.suse.com/documentation/sles11/stor_admin/data/ 
sec filesystems major.htmlZzbwk8gda) in the SUSE Linux Enterprise Server 11 SP3 Storage 
Administration Guide (http://www.suse.com/documentation/sles11/stor admin/data/bookinfo.html) 


Access Control 


Btrfs uses the POSIX access control model. 


Availability 


Btrfs is a logging-style file system. Instead of journaling the block changes, it writes them in a new 
location, then links the change in. Until the last write, the new changes are not committed. 


Btrfs provides writable snapshots with the SUSE Snapper infrastructure that allow you to easily roll 
back your system if needed after applying updates, or to back up files. Snapper allows you to create 
and delete snapshots, and to compare snapshots and revert the differences between them. For 
information about Snapper and its integration in ZYpp (snapper-zypp-plugin) and YaST 2 (yast2- 
snapper), see the “Snapshots/Rollback with Snapper” (http://www.suse.com/documentation/sles11/ 
book_sle_admin/data/cha_snapper.html) in the SUSE Linux Enterprise Server 11 SP3 Administration 
Guide (http://www.suse.com/documentation/sles11/book_sle_admin/data/book_sle_admin.html). 


IMPORTANT: Because Birfs is capable of storing snapshots of the file system, it is advisable to 
reserve twice the amount of disk space than the standard storage proposal. This is done 
automatically by the YaST2 Partitioner in the Btrfs storage proposal for the root file system. 


Scalability 


Btrfs is designed to handle very large storage volumes, up to 16 EiB (exbibytes). Its maximum file 
size is 16 EiB. It provides both online and offline expand and shrink capability. 


Speed 


Btrfs is designed to read and write fast. It provides performance features such as fine-grained B-tree 
locking, running checksum operations to their own background threads, and using a cache to reduce 
IO requirements when cleaning up old transactions. 


Btrfs Administration 


The Novell Storage Services (NSS) Management Utility (NSSMU) and Novell Linux Volume Manager 
(NLVM) support the creation, listing, and deletion of Btrfs file systems. The btrfsprogs package is 
required to be installed. 


Btrfs is integrated in the YaST2 Partitioner and AutoYaST. It is available during the installation to allow 
you to set up a solution for the root file system. You can use the YaST2 Partitioner after the install to 
view and manage Btrfs volumes. 


Btrfs administration tools are provided in the btrfsprogs package. For information about using Btrfs 
commands, see the btrfs (8), btrfsck (8), mk£s.btrfs(8), and btrfsct1(8) man pages. For 
information about Btrfs features, see the Btrfs wiki (http://btrfs.wiki.kernel.org). 
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1.3 


Ext2 


The Ext2 file system is the predecessor to Ext3. Ext2 is not journaled. As one of the earliest file 
systems on Linux, Ext2 has been heavily tested and improved over the years. This might be the 
reason why people often refer to it as “rock-solid”. 


Access Control 


Ext2 uses the POSIX access control model. 


Availability 

After a system outage when the file system cannot be cleanly unmounted, e2fsck starts to analyze 
the file system data. Metadata is brought into a consistent state and pending files or data blocks are 
written to a designated directory (called lost+found). In contrast to journaling file systems, e2fsck 
analyzes the entire file system and not just the recently modified bits of metadata. This takes 
significantly longer than checking the log data of a journaling file system. Depending on file system 
size, this procedure can take half an hour or more. Therefore, it is not desirable to choose Ext2 for 
any server that needs high availability. 


Scalability 


Ext2 does not scale well to large volumes or to a great number of files. 


Speed 


Because Ext2 does not maintain a journal and uses significantly less memory, it is sometimes faster 
than other file systems. 


Easy Upgradability to Ext3 


Because Ext3 is based on the Ext2 code and shares its on-disk format as well as its metadata format, 
upgrades from Ext2 to Ext3 are very easy. 


Ext3 


The Ext3 file system is a journaled file system that has the greatest use in Linux today. It is the default 
file system in SUSE Linux Enterprise Server 11 distributions. It is quite robust and quick. Ext3 is 
based on the Ext2 code and shares its on-disk format as well as its metadata format. The reliability 
and solidity of Ext2 is elegantly combined in Ext3 with the advantages of a journaling file system. 


Access Control 


Ext3 uses the POSIX extended access control model. 
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Availability 


Ext3 journaling is designed to take care of both metadata and data integrity and keep them ina 
consistent state. The amount of time to recover an Ext3 file system after an unclean system shutdown 
does not depend on the size of the file system or the number of files; rather, it depends on the size of 
the journal used to maintain consistency. The default journal size takes about a second to recover, 
depending on the speed of the hardware. 


Integrity and performance can be customized by specifying the journaling mode as journal, 
ordered, Or writeback. Enabling Ext3 in the data=journal mode offers maximum security (data 
integrity), but can slow down the system because both metadata and data are journaled. Enabling 
Ext3 in the data=ordered mode ensures both data and metadata integrity, but it uses journaling only 
for metadata. The file system driver collects all data blocks that correspond to one metadata update. 
These data blocks are written to disk before the metadata is updated. As a result, consistency is 
achieved for metadata and data without sacrificing performance. A third option to use is 
data-writeback, which allows data to be written to the main file system after its metadata has been 
committed to the journal. This option is often considered the best in performance. It can, however, 
allow old data to reappear in files after a crash and recovery even though the internal file system 
integrity is maintained. 


IMPORTANT: Ext3 uses the data-ordered option as the default. 


Scalability 


Ext3 does not scale well to large volumes or to a great number of files. The recently added Ext3 h- 
trees feature significantly improves its scalability over Ext2. However, it is still not as scalable as 
some of the other file systems in Linux. With h-trees, Ext3 scales similarly to NTFS. Without h-trees, 
Ext3 handles about 5,000 files in a directory. 


Speed 


Ext3's journaling optimizes hard drive head motion, which typically provides a higher throughput than 
Ext2. The journaling mode you use determines the performance achieved. 


Easy and Highly Reliable Upgrades from Ext2 


The tune2£s utility makes it possible to easily upgrade an Ext2 file system to Ext3 without 
reformatting. 


Downgrading from Ext3 to Ext2 is also easy. Just perform a clean dismount of the Ext3 file system 
and remount it as an Ext2 file system. 


Default Ext3 Inode Size 


To allow space for extended attributes and ACLs for a file on Ext3 file systems, the default inode size 
for Ext3 was increased from 128 bytes on SLES 10 to 256 bytes on SLES 11. The maximum number 
of files that can be stored for an Ext3 file system on SLES 11 is reduced by half as compared to Ext3 
file systems created on SLES 10 because each inode consumes twice the space. As a result, you 
need to use larger partitions to hold the same number of files on SLES 11. The inode setting cannot 
be changed for an existing Ext3 file system unless the file system gets extended. 
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If you do not use extended attributes or ACLs on your ext3 file systems, you can set the inode size to 
128 bytes by using any of the following methods: 


+ Modifying the default for all new Ext3 files: Modify the /etc/mke2fs.conf file to set the 
default inode_ratio to 8192. The value applies to all new Ext3 file systems. 


+ At the command line: Pass the bytes-per-inode option (-i 8192) to the mkfs.ext3 command 
when you create a new Ext3 file system. 


* During installation with YaST: Pass the Bytes per inode option when you create a new Ext3 
file system during the installation. In the YaST Partitioner on the Edit Partition page under 
Formatting Options, select Format partition > Ext3, then click Options. In the File system options 
dialog box, select 8192 from the Bytes per inode drop-down list, then click OK. 


* During installation with autoyast: In an autoyast profile, you can use the £s options tag: 


«fs options» 
«opt bytes per inode> 
«option str»-I«/option str» 
«option value»8192«/option value» 
«/opt bytes per inode» 
«/fs options» 


For information, see SLES11 ext3 partitions can only store 5096 of the files that can be stored on 
SLES10 [Technical Information Document 7009075] (http://www.novell.com/support/kb/ 
doc.php?id-7009075). 


ReiserFS 


The Reiser File System (ReiserFS) is a journaling file system that is designed to improve the 
scalability and performance over the Ext2 and Ext3 file systems. By comparison, ReiserFS provides 
better disk space utilization, better disk access performance, faster crash recovery, and reliability 
through data journaling. 


Access Control 


ReiserFS uses the POSIX extended access control model. 


Availability 


ReiserFS uses ordered journaling by default. The file system driver collects all data blocks that 
correspond to one metadata update. These data blocks are written to disk before the metadata is 
updated. As a result, consistency is achieved for metadata and data without sacrificing performance. 
The commit policy depends on the journal size but is based on the number of blocks to commit. Using 
a journal to keep track of recent metadata changes makes a file system check a matter of seconds, 
even for huge file systems. 


Scalability 


ReiserFS provides the best performance and scalability when there are many files and the files are 
small. It scales and performs extremely well on Linux, out-scaling Ext3 with h-trees. In addition, 
ReiserFS is designed to very efficiently use disk space. As a result, it is a good choice on Linux where 
there are many small files in the file system. Because collaboration (email) and many web serving 
applications have many small files, ReiserFS is best suited for these types of workloads. 
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Speed 


For small files, file data and inode information are often stored next to each other. They can be read 
with a single disk I/O operation, meaning that only one access to disk is required to retrieve all the 
information needed. 


XFS 


The XFS file system is a highly scalable, high-performance 64-bit journaling file system that is 
designed to meet extreme computing challenges. XFS is very good at manipulating large files and 
performs well on high-end hardware. 


Access Control 


XFS uses the POSIX extended access control model. 


Availability 


XFS supports metadata journaling, which facilitates quicker crash recovery. The journal can be stored 
within the data section (an internal log) of the file system, or on a separate device to minimize disk 
contention. On XFS, the journal tracks high-level operations that are being performed. Journal 
updates are performed asynchronously to avoid incurring a performance penalty. If a server crash 
occurs, XFS retains file system consistency by redoing operations that were incomplete prior to the 
crash. Recovery occurs at mount time. The recovery speed is independent of the size of the file 
system. If recently modified data was not flushed to disk before a system crash, XFS zeros any 
unwritten data blocks on reboot in order to avoid any possible security issues that might be caused by 
residual data. 


Scalability 


XFS originated at Silicon Graphics, Inc. (SGI) for Irix and was designed specifically for large files and 
large volume scalability. It scales to petabyte volumes to handle extremely large file systems (up to 16 
exabytes), files (8 exabytes), and directory structures (tens of millions of entries). Video and multi- 
media files are best handled by this file system. 


XFS uses allocation groups that can be independently addressed by the file system. This allows 
concurrent file system access to groups by multiprocessor systems. 


Speed 


Before writing the data to the file system, XFS reserves (preallocates) the free space needed for a 
file. Thus, file system fragmentation is greatly reduced. Performance is increased because the 
contents of a file are not distributed throughout the file system. 


Free space and inodes are handled by B+ trees inside the allocation groups. The use of B+ trees 
greatly contributes to XFS’s performance and scalability. 


XFS uses delayed allocation to reduce the number of writes it needs to make. It holds a pending 
transaction in RAM and reserves the appropriate amount of space, but does not write it immediately. 
Some short-lived temporary data might become obsolete by the time XFS decides where actually to 
save it, so it does not need to be written. In this way, XFS increases write performance and reduces 
file system fragmentation. Because delayed allocation results in less frequent write events than in 
other file systems, it is likely that data loss after a crash during a write is more severe. 
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Proprietary Versions 


SGI offers a closed source cluster parallel version of XFS called cXFS, which uses an asymmetrical 
model. The unique feature of cXFS is that its slave nodes can run on UNIX, Linux, and Windows, 
making it a cross-platform file system. Its master node must run on SGI hardware. 


What’s Next 


To use NSSMU to create and manage Linux POSIX volumes and LVM volumes, see Chapter 6, 
“Managing Linux Volumes with NSSMU,” on page 33. 


To use NLVM commands to create and manage Linux POSIX volumes and LVM logical volumes, see 
Chapter 7, “Managing Linux Volumes with NLVM Commands," on page 59. 


To use NSSMU or NLVM to cluster-enable LVM volume groups and logical volumes, see Chapter 8, 
“Clustering LVM Volume Groups with Novell Cluster Services,” on page 79. 
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2.1 


2.2 


What’s New or Changed for Linux POSIX 
Volumes 


This section describes the changes made to the management of Linux POSIX volumes with the 
Novell Linux Volume Manager (NLVM) and the Novell Storage Services Management Utility (NSSMU) 
since the Novell Open Enterprise Server (OES) 11 release. 


* Section 2.1, "What's New (OES 11 SP3),” on page 17 
* Section 2.2, "What's New (OES 11 SP2),” on page 17 
* Section 2.3, "What's New (OES 11 SP1),” on page 20 
* Section 2.4, "What's New (OES 11),” on page 23 


What's New (OES 11 SP3) 


Besides bug fixes, there are no other changes for this component. 


What's New (OES 11 SP2) 


The NLVM and NSSMU management tools support Linux POSIX volumes on OES 11 SP2 running on 
64-bit SUSE Linux Enterprise Server (SLES) 11 Service Pack (SP) 3. 


NSSMU 


In addition to bug fixes, the following changes and enhancements were made in NSSMU for Linux 
POSIX volume management in the OES 11 SP2 release. 


General 


* Novell Type Partitions: NetWare type partitions are now referred to as Novell type partitions in 
guides, help, and error messages. 


Devices 


* Unsharing a device: The NSSMU Devices page allows you to disable the Shareable for 
Clustering state for a device without stopping Novell Cluster Services on the node. The 
command fails if the device contributes space to an SBD partition, or to a shared pool or a 
cluster-enabled pool that is used in any cluster resource. Previously, it was necessary to 
temporarily stop Novell Cluster Services in order to unshare a device after you disabled 
clustering for a pool. 


Linux Volumes 


* Creating Linux Volumes: 


* Devices: The device selection was modified to allow you to alternatively select a shared 
device with no data partitions or an uninitialized device for a clustered LVM volume. 
Previously, only unshared initialized devices were available for selection. 
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* Enforcing Name Restrictions for NCP Enabled LVM Volumes: For NCP-enabled LVM 
volumes, the NSSMU utility has been modified to enforce the NCP length restriction of 14 
characters and to use uppercase letters for the name in the Novell Cluster Services cluster 
resource scripts for a cluster-enabled LVM volume. Previously, a new LVM volume cluster 
resource would go comatose immediately after creation if the name specified with the 
NCP_VOLUME parameter in the script was more than 14 characters, or if it included 
lowercase letters. 


Availability for prior releases: November 2012 Scheduled Maintenance for OES 11 SP1 


* Linux POSIX Volumes Are Not Supported on NSS Software RAIDs: Linux POSIX file 
systems should not be created on NSS software RAIDs. NSSMU has been modified to 
block NSS software RAIDs from being presented as device options when you create a 
Linux POSIX volume. 


Availability for prior releases: September 2012 Scheduled Maintenance for OES 11 and 
OES 11 SP1 


* Mounting a Linux volume: The NSSMU Linux Volumes menu option F7 allows you to mount 
non-LVM and LVM volumes in Linux using the mount parameters stored in the /etc/fstab file. 
You can optionally specify the mount options. If the Linux volume is NCP-enabled, it also 
automatically mounts the volume for NCP, and NCP assigns it a volume ID. 


* Unmounting a Linux volume: The NSSMU Linux Volumes menu option F7 allows you to 
unmount non-LVM and LVM volumes in Linux. If the Linux volume is NCP-enabled, it also 
automatically dismounts the volume for NCP before it dismounts it in Linux. 


* Logging NCP volume dismounts: NCP Server has been modified to automatically log 
dismounts of NCP-enabled volumes, including NSS volumes and NCP-enabled Linux volumes. 


Availability for prior releases: January 2013 Scheduled Maintenance for OES 11 and OES 11 
SP1 


NLVM Commands 


In addition to bug fixes, the following changes and enhancements were made in NLVM commands for 
Linux POSIX volume management in the OES 11 SP2 release. For information about NLVM 
commands and usage, see the OES 11 SP2: NLVM Reference (http:/Awww.novell.com/ 
documentation/oes11/stor nlvm lx/data/bookinfo.html). 


General 


* Novell Type Partitions: NetWare type partitions are now referred to as Novell type partitions in 
guides, help, and error messages. 


+ NLVM options: The following enhancements were made to NL VM Options (http:// 
www.novell.com/documentation/oes11/stor nlvm lx/data/nlvmopt.html): 


* NLVM options can appear in any order in the command after n1vm. Previously, the NLVM 
options had to follow immediately after n1vm. 


+ The --terse (http://www.novell.com/documentation/oes11/stor nlvm lx/data/ 
nivmopt.html#nlvmopt_terse) option can be used with nlvm list commands to display the 
output in a format for parsing. Values are labeled in the format ParameterName-value. 
Information about a storage object is output in a single line. If the target object contains 
storage objects (such as partitions on a device or segments in a software RAID), 
subsequent lines contain information about each of its member objects. 


* Common options: The common options more and a11 were added for use with the following 
nlvm list commands to provide additional details beyond the standard output. You can use 
them with or without the --terse NLVM option. 
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nlvm [-t] list devices [exclude] [more|all] 

nlvm [-t] list linux volumes [more |all] 

nlvm [-t] list moves [more |all] 

nlvm [-t] list partitions [device] [mask] [more |all] 
nlvm [-t] list pools [exclude] [more |all] 

nlvm [-t] list snaps [more |all] 

nlvm [-t] list volumes [more |all] 


See "Common Options" (http://www.novell.com/documentation/oes11/stor nlvm lx/data/ 
nlvm common options.html). 


* Viewing Error Code Messages: The NSS utility now provides an /err switch that can be used 
from the command prompt. You can use this option to view an error message if a failed NLVM 
command line operation provides an error code without a corresponding message. 


nss /err-«error code number» 


For information about error codes, see "NLVM Error Codes" (http://www.novell.com/ 
documentation/oes11/stor nlvm lx/data/nlvm ec.html). 


Availability for prior releases: November 2012 Scheduled Maintenance for OES 11 SP1 
Devices 


+ Unsharing a device: The nlvm unshare «device name» (http://www.novell.com/ 
documentation/oes11/stor nlvm lx/data/unshare.html) command allows you to disable the 
Shareable for Clustering state for a device without stopping Novell Cluster Services on the node. 
The command fails if the device contributes space to an SBD partition, or to a shared pool or a 
cluster-enabled pool that is used in any cluster resource. Previously, it was necessary to 
temporarily stop Novell Cluster Services in order to unshare a device after you disabled 
clustering for a pool. 


Partitions 


* Creating a partition: The type-«partition type» option in the nlvm create partition 
(http://www.novell.com/documentation/oes11/stor nlvm lx/data/create part.html) command 
added support for partition type 1ac for snap partitions. 


Linux Volumes 


* Creating a Linux volume: The following enhancements and changes were made to the n1vm 
create linux volume (http://www.novell.com/documentation/oes11/stor nlvm Ix/data/ 
create Ixvol.html) command: 


* Devices option: The device-«device name» option was modified to allow you to 
alternatively specify a shared device with no data partitions or an uninitialized device for a 
clustered LVM volume. Previously, you could specify only an unshared initialized device. 


* Partition option: The part-«partition name» option allows you to specify an existing 
partition as the location for a non-clustered Linux volume. It can be used instead of the 
device and size options. 


* Size: The minimum size for a Linux volume was increased from 1 MB to 8 MB. This change 
is consistent with the minimum size allowed in NSSMU. 


+ NCP volume ID for clustered LVM volumes: The volid-«ncp volume id» option can be 
used in combination with the shared and ncp options to specify an NCP volume ID for an 
NCP-enabled clustered LVM volume. If the volid option is not used, an ID is automatically 
assigned by Novell Cluster Services when the resource is created. This allows you to 
assign an NCP volume ID that is unique across all nodes in a cluster, and across all nodes 
in every peer cluster in a Business Continuity Cluster. 
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* Enforcing name restrictions for NCP-enabled LVM volumes: For NCP-enabled LVM 
volumes, the nlvm create linux volume command has been modified to enforce the 
NCP length restriction of 14 characters, and to use uppercase letters for the name in the 
Novell Cluster Services cluster resource scripts for a cluster-enabled LVM volume. 
Previously, anew LVM volume cluster resource would go comatose immediately after 
creation if the name specified with the NCP_VOLUME parameter in the script was more 
than 14 characters, or if it included lowercase letters. 


Availability for prior releases: November 2012 Scheduled Maintenance for OES 11 SP1 


* Linux POSIX Volumes Are Not Supported on NSS Software RAIDs: Linux POSIX file 
systems should not be created on NSS software RAIDs. NLVM commands have been 
modified to block NSS software RAIDs from being used as a device when you create a 
Linux POSIX volume. 


Availability for prior releases: September 2012 Scheduled Maintenance for OES 11 and 
OES 11 SP1 


+ Listing details for a Linux volume: The nivm list linux volume «1x volume name» (http:/ 
Iwww.novell.com/documentation/oes11/stor nlvm lx/data/list Ixvol.html) command displays 
detailed information for a specified Linux volume. 


+ Mounting a Linux volume: The nivm linux mount «1x volume name» (http:// 
www.novell.com/documentation/oes11/stor nlvm lx/data/linux mount.html) command allows 
you to mount non-LVM and LVM volumes in Linux using the mount parameters stored in the / 
etc/fstab file. You can optionally specify the mount options. If the Linux volume is NCP- 
enabled, it also automatically mounts the volume for NCP, and NCP assigns it a volume ID. 


* 


Unmounting a Linux volume: The nivm linux unmount «1x volume name» (http:// 
www.novell.com/documentation/oes11/stor nlvm lx/data/linux unmount.html) command allows 
you to unmount non-LVM and LVM volumes in Linux. If the Linux volume is NCP-enabled, it also 
automatically dismounts the volume for NCP before it dismounts it in Linux. 


Linux Volume Support in SLES 11 SP3 
For information about Linux volume support changes in SUSE Linux Enterprise Server 11 SP3, see 
“What's New in SLES 11 SP3” (http://www.suse.com/documentation/sles11/stor admin/data/ 


new sles11sp3.html) in the SUSE Linux Enterprise Server 11 Storage Administration Guide (http:// 
www.suse.com/documentation/sles11/stor_admin/data/bookinfo.html). 


2.3 What's New (OES 11 SP1) 


The NLVM and NSSMU management tools support Linux POSIX volumes on OES 11 SP1 running on 
64-bit SUSE Linux Enterprise Server (SLES) 11 Service Pack (SP) 2. 
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NSSMU 


In addition to bug fixes, NSSMU provides the following changes and enhancements for Linux POSIX 
volume management in the OES 11 SP1 release: 
* Create Linux Volume: 


* The NCP Enable option can be used to enable the Linux POSIX file system on the volume 
to be accessed with the NetWare Core Protocol (NCP). 


* Support was added for the Btrfs file system. The Btrfs file system is now available as an 
alternative to other supported file systems (Ext2, Ext3, Reiserfs, and XFS) when you create 
a Linux volume. The btrfsprogs package is required. You can use NSSMU or NLVM to 
manage the Btrfs volumes as you would manage other Linux data volumes. Btrfs volumes 
can also be configured for NCP file access and for clustering with Novell Cluster Services. 


* Confirmation Prompt: You are automatically prompted to confirm actions for certain commands 
that destroy data, such as when you initialize a device or delete Linux POSIX volumes. 


* File System Types: When you create a Linux POSIX volumes, the supported file system types 
are now listed in alphabetical order: btrfs, ext2, ext3, reiserfs, and xfs. 


* Linux Volume Details: On the Linux Volumes page, a volume's information includes the NCP 
Enabled parameter and status (Yes or No). 


* Mount Point Path: The default mount point path for Linux volumes is /usr/novell/ 
«volume name». 


* Partitions: On the NSSMU Partitions page, the Partitions list panel has been widened to 
accommodate long partition names. If you widen the NSSMU display screen, it widens the 
Partitions list panel and allows you to see the partitions' full names. 


NLVM Commands 


In addition to bug fixes, NLVM commands provide the following changes and enhancements for Linux 
POSIX volume management in the OES 11 SP1 release: 
* Sizes: The following enhancements are available for the size option: 
* The default multiplier for sizes was changed from M (megabytes) to G (gigabytes). If no 
multiplier is provided, the value is assumed to be in gigabytes. For example: 
Size-20 (20 gigabytes is used) 
* Use the T multiplier to specify sizes in terabytes (TB). 


* All sizes can be entered as whole numbers or with fractional parts such as 200.45G and 
3.98T. 


* Multiple Devices: You can specify multiple devices for the following commands: 


* Init: You can specify multiple devices to be initialized at the same time. Each device is 
formatted with the same specified partitioning scheme and share state. 


* Share: You can specify multiple devices to be shared at the same time. 
* Unshare: You can specify multiple devices to be unshared at the same time. 


* No Prompt: The --no-prompt NLVM option can be used with the n1vm delete linux volume 
command and the n1vm init command to prevent a confirmation message from being 
displayed. 


* Confirmation Prompt: You are automatically prompted to confirm actions to initialize a device 
or to delete a Linux POSIX volume. 
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* Create Linux Volume: 


* Support was added for the Btrfs file system. The Btrfs file system is now available as an 
alternative to other supported file systems (Ext2, Ext3, ReiserFs, and XFS) when you create 
a Linux volume. The btrfsprogs package is required. You can use NSSMU or NLVM to 
manage the Btrfs volumes as you would manage other Linux data volumes. Btrfs volumes 
can also be configured for NCP file access and for clustering with Novell Cluster Services 


* The ncp option for the nlvm create linux volume command can be used to enable the 
Linux POSIX file system on the volume to be accessed with the NetWare Core Protocol 
(NCP). 


+ List Linux Volumes: The volume information displays Nc» if the Linux volume is enabled for 
NCP. 


Btrfs File System 


NSSMU, NLVM Linux commands, NCP Server, and Novell Cluster Services were modified to support 
the Btrfs file system for Linux volumes. The Btrfs file system is now available as an alternative to 
other supported file systems (Ext2, Ext3, Reiserfs, and XFS) when you create a Linux volume. The 
btrfsprogs package is required. You can use NSSMU or NLVM to manage the Btrfs volumes as you 
would manage other Linux data volumes. Btrfs volumes can also be configured for NCP file access 
and for clustering with Novell Cluster Services. 


SUSE Linux Enterprise Server (SLES) 11 Service Pack 2 (SP2) also supports the Btrfs file system in 
the YaST2 Partitioner. You can use the Partitioner during the system installation to configure a Btrfs 
solution for the system device. YaST2 automatically installs the btr£sprogs package if you use Btrfs 
for the root (/) file system. Bootloader support for /boot on Btrfs is not available in SLES 11 SP2; it is 
planned to be available beginning in SUSE Linux Enterprise 12. 


For information about the features of Btrfs, see "Btrfs" (http://www.novell.com/documentation/oes11/ 
stor posixvol lx/data/bwk8gda.html) in the OES 11 SP1: Linux POSIX Volume Administration Guide 
(http://www.novell.com/documentation/oes11/stor posixvol lx/data/bookinfo.html). 


NCP Volumes and Cluster Resources 


NSSMU and NLVM were modified to support the creation of NCP volumes on Linux POSIX file 
systems. You can NCP enable Linux POSIX volumes, an LVM volumes, and clustered LVM volumes 
as you create them. When you enable NCP for a Linux volume, an NCP volume of the same name 
(using all capital letters) is automatically created. An NCP share is created at the root of the Linux 
volume. 


For clustered LVM volumes, the NCP Virtual Server object is automatically created and the NCP 
mount, dismount, and status commands are added to the scripts for the LVM volume group cluster 
resource. The Novell Cluster Services Generic File System template is used to specify the default 
cluster policies and scripts for the cluster resource. After you create the resource, you can use the 
Clusters plug-in for iManager to set up preferred nodes for the resource and to manage the resource. 


Linux Volume Support in SLES 11 SP2 


For information about Linux volume support changes in SUSE Linux Enterprise Server 11 SP2, see 
“What's New in SLES 11 SP2” (http://www.suse.com/documentation/sles11/stor admin/data/ 
bwkb7my.html) in the SUSE Linux Enterprise Server 11 Storage Administration Guide (http:// 
WwWw.suse.com/documentation/sles11/stor admin/data/bookinfo.html). 
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What’s New (OES 11) 


The NLVM and NSSMU management tools support Linux POSIX volumes on OES 11 running on 64- 
bit SUSE Linux Enterprise Server (SLES) 11 Service Pack (SP) 1. 


Creating Linux Volumes with NSSMU and NLVM Commands 


For Novell Open Enterprise Server (OES) 11 servers, the Novell Storage Services Management 
Utility (NSSMU) and the Novell Linux Volume Manager (NLVM) commands allow you to create, 
mount, and delete the following Linux POSIX storage objects: 


* Linux POSIX volumes (non-LVM volumes) 


¢ Linux Logical Volume Manager 2 (LVM2) volume groups and LVM logical volumes 


* Shared Linux Clustered LVM (cLVM) volume groups and logical volumes that are cluster- 
enabled with Novell Cluster Services 


Linux Volume Support in SLES 11 SP1 


For information about Linux volume support changes in SUSE Linux Enterprise Server 11 SP1, see 
“What’s New in SLES 11 SP1” (http://www.suse.com/documentation/sles11/stor_admin/data/ 
bndgyod.html) in the SUSE Linux Enterprise Server 11 Storage Administration Guide (http:// 
www.suse.com/documentation/sles11/stor_admin/data/bookinfo.html). 


Linux Volume Support in SLES 11 


For information about Linux volume support changes in SUSE Linux Enterprise Server 11, see 
“What's New in SLES 11" (http://www.suse.com/documentation/sles11/stor_admin/data/ 
bndgyoe.html) in the SUSE Linux Enterprise Server 11 Storage Administration Guide (http:// 
www.suse.com/documentation/sles11/stor_admin/data/bookinfo.html). 


What's New or Changed for Linux POSIX Volumes 23 


24 OES 11 SP3: Linux POSIX Volume Administration Guide 


3.1 


3.2 


3.3 


Installing or Upgrading NSS 
Management Tools and Linux POSIX File 
Systems 


This section describes the installation and upgrade requirements for using Novell Storage Services 
(NSS) management tools to manage Linux POSIX volumes on your Novell Open Enterprise Server 
(OES) 11 SP3 server. 

* Section 3.1, “NSS Management Tools,” on page 25 

+ Section 3.2, "Linux POSIX File Systems,” on page 25 

+ Section 3.3, “Clustered LVM,” on page 25 


NSS Management Tools 


In OES 11 and later, you can use the NSS Management Utility (NSSMU) and the Novell Linux Volume 
Manager (NLVM) to manage Linux POSIX volumes. For general information about installing, 
upgrading, and patching your OES 11 (or later) server, see the OES 11 SP3: Installation Guide. 


During the OES installation, select the Novell Storage Services pattern from the list of OES Services 
This automatically installs NSSMU and NLVM. 


Updates for the NSS management tools are delivered in the OES 11 (or later) patch channels. 


Linux POSIX File Systems 


The software packages for most of the Linux POSIX file systems (such as Ext2, Ext3, ReiserFS, and 
XFS) are installed and upgraded by default whenever you install or upgrade the SUSE Linux 
Enterprise Server (SLES) 11 SP 1 (or later) operating system on your OES 11 (or later) server. No 
action is required. 


The Btrfs file system is available on SLES 11 SP2 or later. Using the Btrfs file system requires the 
btrfsprogs package. The package is installed automatically if you select Btrfs as the file system for 
the system device when you install the SLES 11 SP2 (or later) operating system. Otherwise, the 
btrfsprogs package must be installed manually by using the YaST 2 Software Installer. Thereafter, 
the package is updated by default whenever you patch or upgrade your system. 


Updates for the Linux POSIX file systems and the btrfsprogs package are delivered via the SLES 
11 SP2 (or later) patch channel. 


Clustered LVM 


Clustered LVM (CLVM) requires the Linux kernel 2.6.32.45-0.3 or later. You can get the latest kernel 
version by using the SLES 11 SP4 update channel. 
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Using NLVM and NSSMU in a Virtualized 
Environment 


The Novell Linux Volume Manager (NLVM) utility and Novell Storage Services Management Utility 
(NSSMU) run in a virtualized environment just as they do on a physical server running Novell Open 
Enterprise Server 11 and later, and require no special configuration or other changes. 


* For information on setting up virtualized OES machines, see "Installing, Upgrading, or Updating 
OES on a VM” in the OES 11 SP3: Installation Guide. 


* To get started with Xen virtualization, see the Virtualization with Xen documentation (http:// 
www.suse.com/documentation/sles11/book_xen/data/book_xen.html). 


* To get started with KVM virtualization, see the Virtualization with KVM documentation (http:// 
www.suse.com/documentation/sles11/book_kvm/data/book_kvm.html). 


¢ To get started with third-party virtualization platforms, such as Hyper-V from Microsoft and the 
different VMware product offerings, refer to the documentation for the product you are using. 


Using NLVM and NSSMU in a Virtualized Environment 


27 


28 OES 11 SP3: Linux POSIX Volume Administration Guide 


5.1 


5.2 


Planning for Linux POSIX Volumes 


Consider the requirements and caveats in this section when planning to use the Novell Storage 
Services (NSS) Management Utility (NSSMU) or Novell Linux Volume Manager (NLVM) command 
line commands to manage Linux POSIX volumes on your Novell Open Enterprise Server (OES) 11 
SP3 servers. 

+ Section 5.1, “Root User,” on page 29 

+ Section 5.2, “Using RAID Devices for Linux POSIX Volumes,” on page 29 


+ Section 5.3, "Naming Conventions for Linux LVM Volume Group and Logical Volume Names,” on 
page 30 

+ Section 5.4, "Naming Conventions for NCP Volume Names,” on page 31 

+ Section 5.5, “Linux LVM Volume Groups,” on page 31 

* Section 5.6, “Linux LVM Volume Group Cluster Resources,” on page 31 

* Section 5.7, "Using Antivirus Software with NCP Volumes,” on page 31 


Root User 


The Linux system root user privileges are required to use NSSMU and the NLVM commands. 


Using RAID Devices for Linux POSIX Volumes 


You can use a hardware RAID device to achieve device fault tolerance for Linux POSIX volumes. 
Novell Storage Services (NSS) management tools can see and use any available free space on a 
hardware RAID device. 


We recommend that you do not use Linux software RAIDs (such as MD RAIDs and Device Mapper 
RAIDs) for devices that you plan to use for storage objects that are managed by NSS management 
tools. The Novell Linux Volume Manager (NLVM) utility and the NSS Management Utility (NSSMU) 
list Linux software RAID devices that you have created by using Linux tools. Beginning with Linux 
Kernel 3.0 in OES 11 SP1, NLVM and NSSMU can see these devices, initialize them, and allow you 
to create storage objects on them. However, this capability has not yet been fully tested. 


IMPORTANT: In OES 11, a server hang or crash can occur if you attempt to use a Linux software 
RAID when you create storage objects that are managed by NSS management tools. 


Linux software RAID devices do not support concurrent activation on multiple nodes, and are not 
cluster aware. They cannot be used for shared disk storage objects such as cLVM volume groups 
and the Novell Cluster Services SBD (split-brain detector) partitions. 


NSS software RAID devices are supported for use with NSS pools and Novell Cluster Services SBD 
(split-brain-detector) partitions. Linux POSIX file systems are not supported on NSS software RAID 
devices. 
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5.3 


5.3.1 


5.3.2 


5.3.3 


IMPORTANT: Do not create linux partitions (or any non-Novell type partition) on an NSS software 
RAID device. Doing so causes all pool creations on that RAID device to fail. 


Naming Conventions for Linux LVM Volume Group 
and Logical Volume Names 


Consider the following conventions for naming Linux Logical Volume Manager (LVM) volume groups 
and logical volumes: 


+ Section 5.3.1, "NSSMU and NLVM Requirements for LVM Names,” on page 30 
+ Section 5.3.2, “LVM Requirements for LVM Names,” on page 30 


* Section 5.3.3, "Novell Cluster Services Requirements for Clustered LVM Volume Names,” on 
page 30 


NSSMU and NLVM Requirements for LVM Names 


NLVM and NSSMU require that Linux LVM volume group names and logical volume names be unique 
from any volume, device, pool, RAID, and other Device Mapper name. The LVM group name is 
limited to 128 characters. The LVM logical volume name is limited to 64 characters. 


If you enable NCP for the volume, see Section 5.4, "Naming Conventions for NCP Volume Names," 
on page 31. 


LVM Requirements for LVM Names 


LVM2 allows volume group names and logical volume names to contain characters A to Z, a to z, O to 
9, underscore ( ), hyphen (-), dot (.), and plus (+). The names cannot begin with a hyphen. 


Reserved names and character strings that are used internally by LVM cannot be used as volume 
group names or logical volume names. A volume group cannot be called anything that exists in /dev/ 
at the time of creation. It cannot be named '.' (a single dot) or '. .' (double dot). 


A logical volume cannot be named the following reserved words: 
(a single dot) 
(double dot) 

snapshot 


pvmove 


The logical volume name also cannot contain the following strings: 


_mlog 
_mimage 


Novell Cluster Services Requirements for Clustered LVM 
Volume Names 


In a Novell Cluster Services cluster, the names of clustered LVM volume groups and logical volumes 
must be unique across all nodes in the cluster. 
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5.5 


5.6 


5.7 


Naming Conventions for NCP Volume Names 


NCP volume names can be up to 14 alphanumeric characters, using uppercase letters A through Z 
and numbers 0 through 9. Underscores (_) are allowed. 


If you NCP enable a Linux volume as you create it with NSSMU or the nlvm create linux volume 
command, the NCP volume name uses the specified Linux volume name, but all letters are 
capitalized. NCP treats the Linux volume name as case insensitive. Ensure that the specified Linux 
volume name does not exceed 14 characters, does not use special characters, and is unique across 
all nodes in the cluster for both Linux and NCP. 


Linux LVM Volume Groups 


NLVM uses the Linux Logical Volume Manager to create volume groups. LVM requires that the 
devices you use to create a volume group are already initialized and contain no partitions. LVM uses 
the entire device for the volume group. 


Linux LVM Volume Group Cluster Resources 


Novell Cluster Services 2.1, NLVM, and NSSMU use the Clustered Logical Volume Manager (CLVM) 
to manage LVM volume group cluster resources. CLVM requires the Linux kernel 2.6.32.45-0.3 or 
later. You can get the latest kernel version by using the SLES 11 SP4 update channel. 


When you create clustered LVM volume groups on shared storage, all of the nodes in the cluster 
must have shared physical access to the devices that you want to use to create the volume group. A 
quorum of nodes must be present in the cluster. The volume group cluster resource is brought online 
on only one node at a time. 


LVM requires that the devices you use to create a volume group are already initialized and contain no 
partitions. In a cluster, a device should be physically attached to all nodes in a cluster. The device 
must not be marked as Shareable for Clustering because that adds a 4 KB partition on the device to 
store the shared state. LVM uses the entire device for the volume group. 


Using Antivirus Software with NCP Volumes 


For information about using antivirus software with NCP volumes, see “McAfee Antivirus Requires 
Additional Configuration” in the OES 11 SP3: Planning and Implementation Guide. 
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6 Managing Linux Volumes with NSSMU 


The Novell Storage Services (NSS) Management Utility (NSSMU) for Novell Open Enterprise Server 
(OES) 11 SP3 allows you to create and manage Linux POSIX file systems. This section describes 
how to use NSSMU to create and manage Linux POSIX volumes on your OES server. 


NSSMU also allows you to create and manage NSS pools, volumes, software RAIDs, and pool 
snapshots. For information, see the OES 11 SP3: NSS File System Administration Guide for Linux. 


* 


* 


* 


* 


* 


Section 6.1, "NSSMU Quick Reference for Linux Volumes," on page 34 

Section 6.2, “Launching and Navigating NSSMU,” on page 35 

Section 6.3, “Viewing a List of Devices,” on page 37 

Section 6.4, “Viewing Device Details,” on page 37 

Section 6.5, “Initializing a Device,” on page 39 

Section 6.6, “Unsharing a Device,” on page 41 

Section 6.7, “Viewing a List of Linux Volumes,” on page 41 

Section 6.8, “Viewing Details for a Linux Volume,” on page 42 
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6.1 


NSSMU Quick Reference for Linux Volumes 


Use this section as a quick reference to manage devices, view partitions, and create and manage 
Linux volumes on your OES 11 or later server. To launch NSSMU, log in to the server as the root 
user, open a terminal console, then enter nssmu. 


IMPORTANT: For information about the NSS file system management features of NSSMU, see the 
“NSS Management Utility (NSSMU) Quick Reference” in the OES 11 SP3: NSS File System 


Administration Guide for Linux. 


Table 6-1 NSSMU Management Options for Linux Volumes 


NSSMU Management Options 


Devices 


F3 = Initialize device (Do not initialize 
your system device.) 


F5 = Refresh display 


F6 = Share (shareable/not shareable for 
clustering) 


Space = Select/Unselect 
F8 = More 


Enter = Show partitions (does not report 
the 4K partition created for Shareable for 
Clustering) 


Esc = Previous menu 


Description 


Use the Devices page to initialize and maintain physical storage 
devices and NSS software RAID devices available to this server. 
Linux volumes cannot use NSS software RAID devices. NSSMU 
does not recognize native Linux software RAID devices. 


Initializing the selected device erases its partition table, effectively 
destroying all of its data. A device that has not been initialized 
reports a partition type of Uninitialized. 


When you initialize a device, you can select the DOS or the GUID 
Partition Table (GPT) partitioning scheme for a given device. 


The DOS partitioning scheme supports devices up to 2 TB 
(terabytes) in size. It allows up to four partitions on a device. 


The GPT partitioning scheme supports device sizes up to 2E64 
sectors (that is, up to 8388608 petabytes (PB) based on the 512- 
byte sector size). It allows up to 128 partitions per disk. Each of its 
disks partitions is a logical device that is identified by a unique 128- 
bit (16-byte) GUID. 


Use Shareable for Clustering only for devices you plan to use for a 
Novell Cluster Services SBD (split brain detector) partition or for a 
cluster enabled NSS pool. 


Clustered Linux LVM volumes require a device that is initialized, 
contains no partitions, and is not shared (Shareable for Clustering is 
set to No.). The entire device is used for the volume group. 
Clustered LVM controls the share state of the device, not the NSS 
Shareable for Clustering setting. 


Partitions 

Ins = Create an NSS partition (disabled) 
Del - Delete an NSS partition 

F3 - Mirror an NSS pool partition 

F5 - Refresh details of the partition 

F6 - Label 

Enter =Show volumes 


Esc - Previous menu 


Use this option to display details about partitions. All types of 
partitions are displayed, including those for Linux POSIX file 
systems, NSS file systems, and NSS software RAIDs. 


If you widen the NSSMU display screen, it widens the Partitions list 
panel and allows you to see the partitions' full names. 


The Create option is disabled. Partitions are automatically created 
as you define Linux volumes, NSS pools, or NSS software RAIDs. 


Do not use the delete and mirror options for Linux POSIX file 
systems. Partitions used for Linux volumes are destroyed 
automatically when you delete the volume from the Volumes page. 
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NSSMU Management Options 
Linux Volumes 

Ins = Create 

Del = Delete 

F3 = Rename 


F5 = Refresh details of the Linux 
volumes 


F7 = Mount or Dismount 


Esc = Previous menu 


Description 


Use the Linux Volumes page to create one of the following types of 
Linux volumes: 


* Native Linux POSIX volumes (non-LVM) 
* LVM volume group and logical volume 


* Clustered LVM volume group, logical volume, Novell Cluster 
Services cluster resource, and NCP virtual server (if NCP is 
enabled) 


* NCP volume. Enabling NCP for a Linux volume automatically 
creates an NCP volume of the same name. The NCP share is 
created at the root of the volume. For a clustered volume, an 
NCP Virtual Server object is created for the cluster resource. 


NSSMU supports Btrfs (requires btrfsprogs), Ext2, Ext3, 
ReiserFS, and XFS file systems. 


You can mount or dismount the Linux volume. 


You can delete a Linux volume. The volume must be dismounted (or 
offline for clustered volumes) before you can delete it. 


You can use Rename to modify the mount point for the volume. 


Launching and Navigating NSSMU 


1 Login to the server as the root user, then open a terminal console. 


2 Launch NSSMU by entering 


nssmu 


Main Menu 


ENTER-Select menu item FS=Refresh all 


3 The NSSMU Main Menu page offers the following options: 
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NSSMU Main Menu 


Devices 


Description 
View information about devices. 
Initialize a device in MSDOS or GPT format. 


Enable or disable a device as Shareable for Clustering. This is used for 
devices that you plan to use as the Split Brain Detector (SBD) for a Novell 
Cluster Services cluster or for NSS pools. 


Partitions 


View a list of partitions on a device, including Linux and LVM partitions. 


If you widen the NSSMU display screen, it widens the Partitions list panel and 
allows you to see the partitions’ full names. 


Pools 


Create and manage NSS pools. 


Create and cluster-enable NSS pools on devices marked as Shareable for 
Clustering. 


Volumes 


Create and manage NSS volumes. 


Linux Volumes 


Create and manage Linux POSIX file systems, such as Btrfs (requires 
btrfsprogs), Ext2, Ext3, Reiser, and XFS. 
You can create the following volume types: 

* Native Linux POSIX volumes (non-LVM) 

* LVM volume group and logical volume 


* Clustered LVM volume group, logical volume, Novell Cluster Services 
cluster resource, and NCP virtual server (if NCP is enabled) 


* NCP volume. Enabling NCP for a Linux volume automatically creates an 
NCP volume of the same name. The NCP share is created at the root of 
the volume. For a clustered volume, an NCP Virtual Server object is 
created for the cluster resource. 


RAID Devices 


Create and manage NSS software RAID devices. 


Snapshots 


Create and manage NSS pool snapshots. 


4 Select a menu option by using the Up-arrow and Down-arrow keys, then press Enter. 


5 When you are done working in a functional area, press Esc to return to the Main Menu page. 


6 From the Main Menu page, press Esc to exit NSSMU. 
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6.4 


Viewing a List of Devices 


You can use NSSMU to view a list of the physical storage devices and NSS software RAID devices 
available to this server. Linux volumes cannot use NSS software RAID devices. NSSMU does not 
recognize native Linux software RAID devices. 


1 From the NSSMU menu, select Devices, then press Enter. 
2 Under Devices, view the device node names of the available devices. 


Device Information 


sdd 


Partitioning type: Uninitiralizec 
RAID: No 
LVM: No 


Unpartiti 


Sharable fo 


F3-Init FS=Refresh F6=Share SPACE=Select/Unselect F8-More 


3 Press the Up-arrow and Down-arrow keys on your keyboard to select a device and view 
information about it. For information, see Section 6.4, "Viewing Device Details," on page 37. 


4 Press Esc twice to exit NSSMU. 


Viewing Device Details 


NSSMU allows you to view the following information about each device: 


Parameter Description 


Name Specifies the Linux device node name in the /dev directory. 


Examples: sda, sdb, sdc, sdd, and so on 


ID Specifies the major and minor number assigned to a block device on 
the server. 


Example: 8:0, 8:16, 8:32, 8:48 
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Parameter 


Partitioning type 


Description 


Specifies if the DOS or GPT partitioning scheme is used to format 
the device. A device that is not partitioned is reported as 
Uninitialized. 


A device that contains a non-mirrored Novell Cluster Services split- 
brain detector (SBD) partition is typically formatted as MS-DOS. A 
device that contains a mirrored SBD partition has a partition type of 
NA (not applicable) because it is a RAID 1 device. 


Values: 


* Uninitialized: The device is not partitioned. 
* DOS: The device is partitioned in MS-DOS format. 
* GPT: The device is partitioned in GUID Partition Table format. 


* CSM: The device contains a legacy Cluster Segment Manager 
partition that was created by using the Enterprise Volume 
Management System (EVMS) on an OES 2 cluster node, and 
has been imported for use on OES 11 (or later) cluster nodes. 


+ LVM2: The entire device is an LVM2 volume group that 
contains an LVM2 logical volume. For example, the device is 
used for a clustered LVM2 volume group and logical volume. 


* NA: The device is an NSS or SBD RAID 1 mirrored device that 
does not have a partitioning scheme. 


RAID Specifies whether the device is an NSS software RAID device. 
Values: Yes or No 

LVM Specifies whether the device contains an LVM volume group. 
Values: Yes or No 

Capacity Specifies the total amount of space available on the device. 


Partitioned space 


Specifies the amount of space in use on the device. 


Unpartitioned space 


Specifies the amount of free unpartitioned space available on the 
device. For MSDOS devices, free space includes unallocated space 
in an extended DOS partition. 


Shareable for clustering 


To view device details: 


The device can be used for shared Novell partitions. Use with Novell 
Cluster Services SBD partitions and cluster-enabled NSS pools. 
The status is stored on a 4 KB partition on the device. 


Values: Yes or No (default) 


1 From the NSSMU menu, select Devices, then press Enter. 


2 Select the device that you want to view by using the Up-arrow and Down-arrow keys. 
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3 View details about a selected device under Device Information. 


Device Intormation 


F3-Init F5=Refresh F6=Share SPACE=Select/Unselect F8=More 


4 Press Esc twice to exit NSSMU. 


Initializing a Device 


You must initialize a device to set up its device format before you can create volumes on it. You can 
also initialize a device to wipe its current structure and reconfigure it. Devices that you want to use for 
Linux POSIX volumes should be in an unshared state whether they are local or SAN devices. 


IMPORTANT: NLVM and NSSMU do not support using Linux software RAID devices and NSS 
software RAID devices with Linux POSIX file systems. You can use a hardware RAID device to 
achieve device fault tolerance for Linux POSIX volumes. 


Initializing a device formats it with an MSDOS or a GPT partitioning scheme. MSDOS supports 
devices up to 2 TB in size. GPT supports devices of any size. The default partitioning scheme is 
MSDOS for devices less than 2 TB, and GPT for devices greater than or equal to 2 TB. NSSMU 
automatically selects the default value in the menu. If you do not want to use the default, you can 
select the other option. If you specify MSDOS for a device that has a size greater than or equal to 2 
TB, the device’s free space is limited to 2 TB; the remainder of the device is unusable space. 
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WARNING: Initializing a device removes all partitions and data from the device. Do not initialize the 
device that contains the operating system. 


1 From the NSSMU menu, select Devices, then press Enter. 

2 Select the device that you want to initialize by using the Up-arrow and Down-arrow keys. 
Information about a selected device is displayed under Device Information. 
If a device has never been initialized, its Partitioning type is reported as Uninitialized. 


Device Intormation 


F3-Init FS-Refresh F6=Share SPACE=Select/Unselect | F8-More. 


3 Press F3 to initialize the device. 
4 Read the warning message, then press y (Yes) to continue, or press n (No) to cancel. 


5 Select the DOS or GPT partitioning scheme, then press Enter. 
DOS supports devices up to 2 TB in size. GPT supports devices of any size. 


6 View the Device Information to confirm that the partitioning type is applied and the unpartitioned 
space shows free space. 
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Unsharing a Device 


The Shareable for Clustering option on the NSSMU Devices page is intended for marking devices as 
shareable that you plan to use for cluster-enabled NSS pools or for Novell Cluster Services SBD (split 
brain detector) partitions. 


For Linux volumes, you use devices that are not marked as shareable for clustering. When you 
cluster-enable an LVM volume group for Novell Cluster Services, clustered LVM controls the share 
state of the device, not the Shareable for Clustering setting. If a device was previously used for an 
NSS pool or SBD partition and is marked as Shareable for Clustering, it contains a small 4 KB 
partition on it to store the state. Before you can create a clustered LVM volume group on the device, 
you must change the device’s Shareable for Clustering state from Yes to No. 


To unshare a device: 


1 From the NSSMU menu, select Devices, then press Enter. 

2 Select the device that you want to unshare by using the Up-arrow and Down-arrow keys. 
3 Press F6 to change the share state of the device from Yes to No. 

4 Press Esc twice to exit NSSMU. 


Viewing a List of Linux Volumes 


You can use the NSSMU Linux Volumes page to view information about Linux POSIX and LVM 
logical volumes that are mounted on the system. 


1 From the NSSMU menu, select Linux Volumes, then press Enter. 


AT D ces 


RA ice 


ENTER-Select menu item F5=Refresh all 
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2 Under Linux Volumes, view the volume name of the available volumes. 


Linux POSIX volumes show the volume name in all caps, such as HOME. Linux LVM logical 
volumes show the volume name as the name you gave the volume when you created it, such as 
lvvol1 or lxvolg. 


Ins=Create Del=Delete F3=Rename FS=Refresh F7=Mount/Dismount ESC=Exit 


3 Use the Up arrow and Down arrow to select a volume and view details about it. 


For information about the fields, see Section 6.8, “Viewing Details for a Linux Volume,” on 
page 42. 


4 Press Esc twice to exit NSSMU. 


68 Viewing Details for a Linux Volume 


NSSMU allows you to view the following information about each Linux volume: 


Parameter Description 
Device Specifies the full device node path. 
Example for a Linux POSIX volume: /dev/sda2 


Example for an LVM volume: /dev/1vvoll/lvvoli 


Mount Point Specifies the path on the root file system where this volume is mounted. 
Examples: 


/mnt /voli 

/home 
/media/ext3/ext3-1 
/mnt/lvvoll 


Mount options Specifies the mount options that are applied whenever this volume is automatically 
mounted after a reboot. 


Example: rw 


Type Specifies the file system type. 


Examples: btrfs (requires btrfsprogs), ext2, ext3, reiserfs, xfs 


Size Specifies the amount of space reserved for this volume. 


Example: 30.58 GB 
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Parameter Description 
Mounted Specifies whether the volume is mounted or unmounted. 


Value: Yes or No 


State Specifies the availability for the file system. 


Example: Read/Write 


LVM Specifies whether the specified volume is an LVM logical volume. 


Value: Yes or No 


NCP enabled Specifies whether the volume is enabled for NCP (NetWare Core Protocol). The 
NCP volume name is the same as the Linux volume name, and the NCP share is 
created at the root of the volume. 


If the volume is cluster-enabled, this information is not reported when the cluster 
resource is in an offline or comatose state. 


Values: Yes or No 


Share State Specifies whether the volume is cluster enabled for Novell Cluster Services. 


Values: Shareable for Clustering or Not Shareable for Clustering 


1 From the NSSMU main menu, select Linux Volumes, then press Enter. 
2 Select a volume from the list of volumes to view details about it. 


For example, the following screen shows details about a native Linux POSIX volume with an 
XFS file system: 


Linux Volumes Volume Information 


Ins=Create Del=Delete 


.F3-Rename FS=Refresh F7=Mount/Dismount ESC=Exit 
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The following screen shows details about an unshared LVM logical volume with an Ext3 file 
system: 


Volume Information 


dev/lvvoll/lvvoll 
RÉ 


clustering 


“Ins=Create Del=Delete F3=Rename FS=Refresh F7=Mount/Dismount  ESC=Exit 
The following screen shows details about a clustered LVM logical volume with an Ext3 file 


system. The Linux Clustered Logical Volume Manager (CLVM) controls and reports the volume 
group’s Share Status as Shareable for Clustering. 


olumes olume Information 


Ins=Create Del=Delete F3=Rename F5=Refresh F7=Mount/Dismount i 


3 Press Esc twice to exit NSSMU. 


6.9 Creating a Non-LVM Linux Volume 


You can use NSSMU to create a native Linux POSIX volume on a device. You must have free 
unpartitioned space available on a device. The device should not be shareable for clustering. 
1 From the NSSMU main menu, select Devices, then press Enter. 


2 View the devices to determine which device you want to use for the volume and the amount of 
space available on it. 


3 If the device has not been initialized, or if you need to reformat the device, initialize the device. 
For information, see Section 6.5, “Initializing a Device,” on page 39. 
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WARNING: Do not initialize a device that contains data you want to keep. 


4 From the NSSMU main menu, select Linux Volumes, then press Enter. 


5 Press Insert to begin creating a new Linux volume. 


6 When you are prompted, specify the following parameters for the volume: 


Parameter 


LVM Type 


Description 
Select Non-LVM2 Volume from the following volume types to create a native 
Linux POSIX volume, then press Enter. 

* Non-LVM2 Volume (local disk) 

+ LVM2 Volume (local disk) 

* Cluster Enabled LVM2 Volume 


Select LVM type 


* -LVM2 Volume (local disk) 


[LE ne [e ) 


NCP 


File System Type 


Enables the Linux POSIX file system on the volume to be accessed with the 
NetWare Control Protocol (NCP). It creates an NCP volume of the same name, 
and creates an NCP share at the root of the volume. 


Select one of the following file system options to make on the volume, then 
press Enter. 


* btrfs (requires btrfsprogs) 
* ext2 
* ext3 


* reiserfs 


Volume type 
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Parameter 


Mount Point 


Description 


Specify the full Linux path where you want to mount the device, the press Enter. 
For example, /mnt /vo11. 


Enter full mountpoint path: /homel 


The last directory is assumed to be the name you want to give the volume. The 
name must be a unique volume name on the server. 


NOTE: If you enable NCP for the volume, the final folder name in the path must 
comply with the limitations for NCP volume names described in Section 5.4, 
"Naming Conventions for NCP Volume Names," on page 31. If you use 
lowercase letters for the volume name, they are automatically changed to 
uppercase for the NCP volume name. 


Make Options 


(Optional) Specify the make options to use for your selected file system, then 
press Enter. 


Enter any make options: | 


For information, see the mkfs(8),mkfs.btrfs(8),mkfs.ext2(8), 
mkfs.ext3(8),mkfs.reiser(8),and mkfs.xfs(8) man pages. 


If a specified make option is invalid for the specified file system, the file system 
creation fails. 


Mount Options 


Specify the default set of options to use when mounting the volume after a 
reboot, then press Enter. 


Enter any mount options: rw 


The Read/Write (rw) mount option is specified by default. 


For information about mount options that are available for each file system, see 
the mount (8) man page. 


OES 11 SP3: Linux POSIX Volume Administration Guide 


Parameter 


Devices 


Description 


Use the Up-arrow and Down-arrow keys to highlight a device from the list, then 
press Insert or Enter to select the device. 


IMPORTANT: NSSMU does not support using Linux software RAID devices and 
NSS software RAID devices with Linux POSIX file systems. You can use a 
hardware RAID device to achieve device fault tolerance for Linux POSIX 
volumes. 


“Ins/ENTER=Select Del=Re ept Select list U=Up D-Down ESC/Q=Prev Menu. 


Partition Size 


For non-LVM volumes and LVM2 volumes, specify the maximum amount of 
space in MB to use from the selected device, then press Enter. 


You can use part or all of the available space on the selected device. 


For cluster-enabled LVM2 volumes, this option is not available. The entire device 
is automatically used by the LVM volume group. 


MB for this segment ——  ESC-Prev Menu. 
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Parameter Description 


Confirm Select F3 to accept and create the Linux POSIX volume. 


7 View the details of the newly created volume. 
For information, see Section 6.8, “Viewing Details for a Linux Volume,” on page 42. 


Linux Volume Information 


F7=Mount/Dismount  ESC=Exit 


8 Press Esc twice to exit NSSMU. 
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You can use NSSMU to create a Linux LVM volume group and logical volume on a device, make a file 
system on the volume, and mount the volume. You must have free unpartitioned space available on a 
device. The device should not be shareable for clustering. 

1 From the NSSMU main menu, select Devices, then press Enter. 


2 View the devices to determine which device you want to use for the volume and the amount of 
space available on it. 
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If the device has not been initialized, or if you need to reformat the device, initialize the device. 


For information, see Section 6.5, “Initializing a Device,” on page 39. 


WARNING: Do not initialize a device that contains data you want to keep. 


From the NSSMU main menu, select Linux Volumes, then press Enter. 


5 Press Insert to begin creating a new Linux LVM logical volume. 
6 When you are prompted, specify the following parameters for the volume: 


Parameter Description 


LVM Type Select LVM2 Volume from the following volume types to create an LVM volume 


group and volume, then press Enter. 
* Non-LVM2 Volume (local disk) 
+ LVM2 Volume (local disk) 


* Cluster Enabled LVM2 Volume 


NCP Enables the Linux POSIX file system on the volume to be accessed with the 
NetWare Control Protocol (NCP). It creates an NCP volume of the same name, 


and creates an NCP share at the root of the volume. 


Volume name Type a name to use for the LVM volume group and logical volume (such as 


lvvol1), then press Enter. 


NOTE: If you enable NCP for the volume, the LVM volume name must comply 
with the limitations for NCP volume names described in Section 5.4, "Naming 
Conventions for NCP Volume Names," on page 31. If you use lowercase letters 
for the volume name, they are automatically changed to uppercase for the NCP 


volume name. 
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Parameter 


File System Type 


Description 


Select one of the following file system options to make on the volume, then 
press Enter: 


* 


btrfs (requires btrf sprogs) 
* ext2 
* ext3 


* reiserfs 


* xfs 


Mount Point 


Make Options 


Specify the full Linux path where you want to mount the device, then press Enter. 
The default path is /usr/novell/«lv volume name». 


Enter full mountpoint path: /mnt/lwol1 


For example, type /mnt/1vvol, then press Enter. 


The mount path's final directory can be the same or different than the name used 
for the logical volume. 


(Optional) Specify the make options to use for your selected file system, then 
press Enter. 


Enter any make options: li 


For information, see the mk£s (8), mk£s.btrfs(8),mkfs.ext2(8), 
mkfs.ext3(8),mkfs.reiser(8),and mkfs.xfs(8) man pages. 


If a specified make option is invalid for the specified file system, the file system 
creation fails. 


Mount Options 


Specify the default set of options to use when mounting the volume after a 
reboot, then press Enter. 


Enter any mount options: rw 


The Read/Write (rw) mount option is specified by default. 


For information about mount options that are available for each file system, see 
the mount (8) man page. 
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Parameter Description 


Devices Use the Up-arrow and Down-arrow keys to highlight a device from the list, then 
press Insert or Enter to select the device. 


Ins/ENTER-Select Del-Remove F3=Accept Select list U-Up D-Down ESC/Q-Prev Menu. 


Partition Size Specify the maximum amount of space in MB to use from the selected device, 
then press Enter. 


You can use part or all of the available space on the selected device. 


Enter partition si 
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Parameter Description 


Confirm Select F3 to accept and create the Linux POSIX volume. 


7 View the details of the newly created volume. 
For information, see Section 6.8, “Viewing Details for a Linux Volume,” on page 42. 


nux Volume Information 


dev/lvvoll/lvvoll 
Let 


harable for Clustering 


Ins=Create Del=Delete F3=Rename FS=Refresh F7=Mount/Dismount  ESC=Exit 


8 Press Esc twice to exit NSSMU. 


6.11 Creating a Shared LVM Volume with Novell Cluster 
Services 


For information about creating a clustered LVM volume group cluster resource with NSSMU, see 
Section 8.3.2, “Creating an LVM Volume Group Cluster Resource with NSSMU,” on page 87 in 
Chapter 8, “Clustering LVM Volume Groups with Novell Cluster Services,” on page 79. 
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6.12 


6.13 


6.14 


Mounting a Linux Volume 


Use the Mount/Dismount option on the NSSMU Linux Volumes page to mount an unmounted Linux 
volume. 


IMPORTANT: If an LVM logical volume is clustered, you must use the cluster online command to 
allow the load script to mount the volume. You can also use the Cluster Manager page in the Clusters 
plug-in for iManager to online a resource. 


1 From the NSSMU menu, select Linux Volumes, then press Enter. 
2 In the Linux Volumes list, select the volume. 
3 In the volume's details, view the volume's current mount status. 
The Mounted status is No if the volume is not mounted. 
4 Press F7 to mount the volume. 
5 Select the volume, then view its details to verify that the Mounted status changes from No to Yes. 
6 Press Esc twice to exit NSSMU. 


Dismounting a Linux Volume 


Use the Mount/Dismount option on the NSSMU Linux Volumes page to dismount a mounted Linux 
volume. 


IMPORTANT: If an LVM logical volume is clustered, you must use the Novell Cluster Services 
cluster offline command to allow the unload script to dismount the volume. You can also use the 
Cluster Manager page in the Clusters plug-in for iManager to online a resource. 


1 From the NSSMU menu, select Linux Volumes, then press Enter. 
2 In the Linux Volumes list, select the volume. 
3 In the volume's details, view the volume's current mount status. 
The Mounted status is Yes if the volume is mounted. 
4 Press F7 to dismount the volume. 
5 Select the volume, then view its details to verify that the Mounted state changes from Yes to No. 
6 Press Esc twice to exit NSSMU. 


Renaming the Mount Point Path for a Linux 
Volume 


The Rename option on the NSSMU Linux Volumes page allows you to modify the mount point of a 
volume. You cannot rename the mount point path for the root (/) volume or other system volumes 
such as /boot. 


An LVM volume name does not depend on the mount point path. For an LVM volume, modifying the 
mount point path in any way does not effect the LVM volume group name and logical volume name. 
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Renaming the mount point path for a non-LVM volume might also cause the volume name to change, 
depending on the change you make to the path. A native Linux POSIX volume assumes its name 
from the final directory in the mount point path. If you change the name of the final directory, the new 
directory name also becomes the new name of the volume. 


The following examples demonstrate how renaming the mount point path for a non-LVM volume can 
affect the volume name: 


Volume Information New Mount Point and Change New Volume Name 

Volume Type: Non-LVM Change the path to the final The volume name does not change. 
: directory. Use the same name for 

Mount Point: the final directory. 

/projects/volpl /old/projects/volp1 


Volume Name: 


/volpi 
Volume Type: Non-LVM Change the final directory name. The new name for the final directory 

: The preceding directories can be becomes the new volume name: 
Mount Point: the same or different. 

| /janebuck 
/home/janedoe /home/janebuck . . 
The final directory name must be 
Volume Name: Or unique as a volume name on the 
server. 

/janedoe /users/janebuck 


The volume is dismounted in order to apply the new mount point path to the volume. The volume is 
not automatically mounted afterwards. 


WARNING: To avoid potential data corruption, you should dismount the volume gracefully before you 
rename it. 


Use the procedure in this section to rename the mount point path for a non-clustered Linux volume. 
For information about modifying the mount point path for a clustered LVM volume, see Section 8.7, 
“Renaming the Mount Point Path for a Clustered LVM Volume,” on page 105. 

1 From the NSSMU main menu, select Linux Volumes, then press Enter. 


2 In the Linux Volumes list, browse each volume to verify that the mount point you want to use is 
not already in use by another volume. 


3 Select the volume of interest. 
4 If the volume is mounted, press F7 to dismount the volume. 


5 Select the volume again, verify that it is not mounted, then press F3 to rename the mount point 
path. 


6 Read the caution message, then press y (Yes) to continue, or press n (No), or press Esc to 
cancel the task. 
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7 In the New Mount Point field, specify the full Linux path of the new mount point that you want to 


use, then press Enter. 


The original mount point path is automatically populated in the New Mount Point field. Modify it 
as needed. 


New mount point: /home/bob2 


8 Select the volume, then view its details to verify that the mount point has changed. 


If the final directory was changed in the mount point path of a non-LVM volume, notice that the 
volume name has changed. The volume is not automatically mounted. 


9 Select the volume, then press F7 to mount the volume. 
10 Select the volume, then view its details to verify that the Mounted status is Yes. 


Renaming a Non-LVM Linux Volume 


The Rename option on the NSSMU Linux Volumes page allows you to modify the mount point of a 
volume. NSSMU uses the name of the last directory in a non-LVM mount point path as the volume 
name for the non-LVM volume. For example, if you create a non-LVM volume with the mount point 
path /usr/novell/1xvol1, the last directory name is 1xvo11, and the non-LVM Linux volume 
becomes 1xvoli. 


Renaming the last directory in a mount point path for a non-LVM volume effectively renames the 


volume. You should gracefully dismount the volume before using the Rename option in NSSMU. For 
information about using the Rename option, see Section 6.14, “Renaming the Mount Point Path for a 


Linux Volume," on page 53. After you rename the volume successfully, you can mount the volume. 


Renaming an LVM Volume 


NSSMU does not provide a way to modify the name of an LVM volume. You can use the Linux 
lvrename command to rename an existing LVM logical volume in a volume group from the old 


volume name to the new volume name. The command does not change the volume group name. You 


should gracefully dismount the volume before attempting to rename it. 


1 Login to the server as the root user, then open a terminal console. 
2 Launch NSSMU and dismount the logical volume: 
2a Atthe command prompt, enter 
nssmu 


2b Select Linux Volumes and press Enter. 
2c Select the LVM volume, then press F7 Dismount. 
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2d Select the volume, then view its details to verify that the Mounted state changes from Yes to 
No. 


2e Press Esc twice to exit NSSMU. 


3 At the command prompt, enter 


lvrename «/dev/vg name/old lv name» </dev/vg_name/new_lv_name> 


Replace vg name with the name of the volume group. If you created the L VM logical volume in 
NSSMU, the volume group name is the same as the logical volume name. If you created the 
LVM logical volume with NLVM or with LVM commands, you might have used a different name 
for the volume group. 


Replace old lv name with the current name of the LVM logical volume. 

Replace new lv name with the new name of the LVM logical volume. 

For example, to change the name of the logical volume on volume group vghome from 1v users 
tO 1v home, enter 


lvrename /dev/vghome/lv users /dev/vghome/lv home 


(Optional) Rename the mount point path that you use for the logical volume. The mount point 
should still be unmounted when you perform this task. 


For information, see Section 6.14, "Renaming the Mount Point Path for a Linux Volume," on 
page 53. 


In a text editor, modify the /etc/fstab file with the new logical volume name. You should also 
specify the new mount point if you renamed it. 


6 Launch NSSMU and mount the renamed LVM logical volume: 


6a Atthe command prompt, enter 


nssmu 
6b Select Linux Volumes and press Enter. 
6c Select the LVM volume, then press F7 Mount. 


6d Select the volume, then view its details to verify that the Mounted state changes from No to 
Yes. 


6e Press Esc twice to exit NSSMU. 


Deleting a Linux Volume 


You can use the Delete option on the NSSMU Linux Volumes page to delete an unclustered Linux 
volume. The volume must be unmounted. 


Deleting the Linux volume does not automatically delete the NCP volume and its Volume object. You 
should remove the NCP volume and its Volume object before you delete the Linux volume. 


WARNING: The delete process removes the partition for the volume, and destroys all of the data on 
the partition. 


Use the procedure in this section to delete unclustered Linux volumes. For information about deleting 
a clustered LVM volume group and logical volume, see Section 8.10, “Deleting a Clustered LVM 
Volume Group and Logical Volume," on page 110. 


1 If you enabled the Linux volume for NCP, use Novell Remote Manager to dismount the NCP 


volume, then remove the NCP volume and its Volume object. 
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For information, see "Removing an NCP Volume" in the OES 11 SP3: NCP Server for Linux 
Administration Guide. 


From the NSSMU menu, select Linux Volumes, then press Enter. 

In the Linux Volumes list, select the volume. 

If the volume is mounted, press F7 to dismount it. 

In the Linux Volumes list, select the volume, then verify that the Mounted state is No. 
Press Delete to delete the volume. 

Press y (yes) to confirm, or press n (no) or Esc to cancel the delete process. 

In the Linux Volumes list, verify that the volume is no longer displayed. 


Press Esc to return to the main menu, then select Devices. 


Select the device that contained the volume, then verify that the amount of free space increased. 


Press Esc twice to exit NSSMU. 
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Managing Linux Volumes with NLVM 
Commands 


The Novell Linux Volume Manager (NLVM) command line interface can be used to create and 
manage Linux POSIX file systems. For information about the syntax and options for the NLVM 
commands used in this section, see the OES 11 SP3: NLVM Reference. 

+ Section 7.1, “NLVM Commands Quick Reference for Linux Volumes,” on page 60 

* Section 7.2, "Viewing a List of Devices," on page 62 

+ Section 7.3, "Viewing Device Details," on page 63 

¢ Section 7.4, “Initializing a Device," on page 64 

¢ Section 7.5, "Unsharing a Device," on page 66 

+ Section 7.6, "Viewing a List of Linux Volumes," on page 66 

+ Section 7.7, “Creating a Non-LVM Linux Volume,” on page 67 

+ Section 7.8, "Creating an LVM Logical Volume," on page 68 

* Section 7.9, "Creating a Shared LVM Logical Volume with Novell Cluster Services," on page 70 

+ Section 7.10, "Mounting Linux Volumes,” on page 70 

+ Section 7.11, "Dismounting Linux Volumes," on page 72 

¢ Section 7.12, "Rescanning for Storage Objects on Known Devices," on page 74 

¢ Section 7.13, “Deleting a Linux POSIX Volume,” on page 75 

+ Section 7.14, "Additional Information," on page 77 
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NLVM Commands Quick Reference for Linux 


Volumes 


Use this section as a quick reference for the NLVM commands that support Linux POSIX volumes. 
Enter commands in a terminal console or script as the root user. For details about each command, 


see the OES 11 SP3: NLVM Reference. 


Task 


Create a clustered Linux LVM volume group and 
logical volume. 


Specify the ncp option to enable NCP for the volume 
and create an NCP share at the root of the volume, 
and to automatically create the NCP Server storage 
object for the cluster resource. 


See also Chapter 8, "Clustering LVM Volume Groups 
with Novell Cluster Services," on page 79. 


Command 


nlvm create linux volume 
type=<btrfs|ext2|ext3|reiserfs|xfs> 
device=<devicename> 
mp-«full mount point path» 
[mmtopt=<fs mount options»] 
lvm 
name-«lv name» 
[group-«vg name>] 
shared 
ip-«resource ip address> 
[ncp] 


Example: 


nlvm create linux volume 
type=xfs 
device=sde 
mp=/mnt/vol42 
mntopt=rw 
lvm 
name-1vmvol42 
shared 
ip=10.10.10.42 


Create a Linux LVM volume group and logical volume. 


Specify the ncp option to enable NCP for the volume 
and create an NCP share at the root of the volume. 


See also Section 7.8, “Creating an LVM Logical 
Volume,” on page 68. 


nlvm create linux volume 
type=<btrfs|ext2|ext3|reiserfs|xfs 
device=<devicename> 
size=<value[K|M|G|T] > 
mp-«full mount point path» 
[mutopt-«fs mount options»] 
lvm 
name-«lv name» 
[group-«vg name>] 
[ncp] 


Example: 


nlvm create linux volume 
type=xfs 
device=sde 
size=511M 
mp-/mnt/vol42 
mntopt-rw 
lvm 
name-1vmvol42 
group-lvmvg42 
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Task 


Create a Linux POSIX volume. 


Specify the ncp option to enable NCP for the volume 


and create an NCP share at the root of the volume. 


See also Section 7.7, “Creating a Non-LVM Linux 
Volume,” on page 67. 


Command 


nlvm create linux volume 
type=<btrfs|ext2|ext3|reiserfs|xfs> 
device=<device_name|anydisk> 
size=<value[K|M|G|T] |max> 
mp-«full mount point path» 
[mntopt-«fs mount options>] 
[ncp] 


Example: 


nlvm create linux volume 
type=ext3 
device=sda 
size=20G 
mp=/mnt/voll 
mntopt=rw 


Delete a Linux volume 


See also Section 7.13.1, “Deleting a Linux POSIX 
Volume,” on page 75. 


See also Section 7.13.2, “Deleting an LVM Volume 
Group and Logical Volume,” on page 76. 


See also Section 8.10, “Deleting a Clustered LVM 
Volume Group and Logical Volume,” on page 110. 


nlvm delete linux volume <volume_name> 


Example: Linux POSIX volume 


nlvm delete linux volume /vol1 


Example: Linux LVM logical volume 


nlvm delete linux volume lvvol1 


Initialize a device 


See also Section 7.4, "Initializing a Device," on 
page 64. 


nlvm [--force] init 
«device name» 
[format=<gpt |msdos»] 
unshared 


Example: 


nlvm init sde format=msdos unshared 


Rescan for storage objects on known devices 


See also Section 7.12, "Rescanning for Storage 
Objects on Known Devices," on page 74. 


Unshare a device 


See also Section 7.5, "Unsharing a Device," on 
page 66. 


nlvm [-m] rescan 


nlvm unshare «device» 


Example: 


nlvm unshare sde 


View a list of active devices 


See also Section 7.2, “Viewing a List of Devices,” on 


page 62. 


nlvm list devices 
[more] 
[exclude=<raid|nonraid|shared| 
nonshared|1vm|nonlvm>] 


View a list of Linux volumes 


See also Section 7.6, “Viewing a List of Linux 
Volumes,” on page 66. 


nivm list linux volumes 


View details for a device 


See also Section 7.3, “Viewing Device Details,” on 
page 63. 


nlvm list «device» 


Example: 


nlvm list device sde 
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7.2 Viewing a List of Devices 


You can use the nlvm list devices command to view information about each of the active devices 
on the system. For command usage information, see “List Devices” in the OES 11 SP3: NLVM 
Reference. 


The command returns the following information: 


Parameter Description Sample Values 
Device name Displays the node name of the device in the /dev sde 

directory. 
Size Displays the total amount of space on the device. 11.0GB 
Free Displays the amount of free unpartitioned space on the OKB 

device. 

199.50GB 

Format Displays the partitioning scheme used to format the MSDOS 


device. MSDOS supports devices up to 2 TB in size. GPT 


supports devices of any size. GPT 

Shared Displays whether the Shareable for Clustering setting is Yes, enabled 
enabled or disabled. The Shareable for Clustering setting . 
should be enabled for devices used in clustered NSS No, disabled 
pools and for SBD partitions. 

RAID Displays whether the device is used as a segment in an Yes or No 


NSS software RAID device. 


If the more option is specified, the information returned for each device is the same as for the n1vm 
list device command. 


1 Login to the server as the root user, then open a terminal console. 


2 View a list of active devices by entering 


nlvm list devices [more|all] [exclude=<raid|nonraid|shared|nonshared|1vm|nonlvm>] 


For example: 
nlvm list devices 
Name Size Used Free Format Shared RAID Enabled 
sda 11.00GB 9.29GB 1.70GB MSDOS No No 
sdb 102.00MB 102.00MB OKB MSDOS Yes No 
sdc 102.00MB 102.00MB OKB MSDOS Yes No 
sdd 512.00MB OKB OKB None No No 
sde 512.00MB OKB OKB None No No 
clusl.sbd 99.57MB 99.57MB OKB None Yes Ji Yes 
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nlvm list devices more 


Name Size Used Free Format Shared RAID Sync 
sda 11.00GB 9.29GB 1.70GB MSDOS No No 
sdb 102.00MB 102.00MB OKB MSDOS Yes No 
sdc 102.00MB 102.00MB OKB MSDOS Yes No 
sdd 512.00MB OKB OKB None No No 
sde 512.00MB OKB OKB None No No 
clusl.sbd 99.57MB 99.57MB OKB None Yes alk Yes 
nlvm list devices all 
Name-sda 
Size-11.00GB(23068672) Used-9.29GB(19486720) Free-1.70GB(3581952) 
Format-MSDOS Shared=No RAID=No M:M=8:0 H:S=255:32 
Partitions on the device: 
Part Type Size Sectors Pool 
sdal Linux 297.00MB 608256 
sda2 Linux Swap 1.00GB 2105344 
sda3 Linux 7.99GB 16771072 
Name=sdb 


Size=102.00MB(208896) Used=102.00MB(208896) Free= 
Format=MSDOS Shared=Yes RAID=No M:M=8:16 H:S=255:32 


Partitions on the device: 


Part Type Size Sectors 
clus134.msbd0 Cluster 99.59MB 203968 
Name=sdc 


Size=102.00MB(208896) Used=102.00MB(208896) Free= 
Format=MSDOS Shared=Yes RAID=No M:M=8:32 H:S=255:32 


Partitions on the device: 


Part Type Size Sectors 
clus134.msbd1 Cluster 99.59MB 203968 
Name=sdd 


OKB (0) 


Pool 


OKB (0) 


Pool 


Size-512.00MB(1048576) Used=512.00MB(1048576) Free=0KB (0) 
Format=MSDOS Shared=No RAID=No M:M=8:48 H:S=255:32 
Partitions on the device: 


Part Type Size Sectors Pool 
sdd1i Linux LVM 509.98MB 1044448 

Name=sde 
Size=512.00MB(1048576) Used=16KB(32) Free=511.98MB (1048544) 
Format=MSDOS Shared=No RAID=No M:M=8:64 H:S=255:3 

Name=sdf 
Size=512.00MB(1048576) Used-16KB(32) Free=511.98MB (1048544) 
Format=MSDOS Shared=No RAID=No M:M=8:80 H:S=255:3 

Name=sdg 


Forma 


Name=clus134.sbd 
Size=99.57MB (203936) Used=99.57MB (203936) Free=0KB (0) 


Forma 


t=GPT Shared=No RAID=No M:M=8:96 H:S=255:32 


t-None Shared-Yes RAID-1 Sync-Yes M:M=253:0 


Segs-2 Enbl-Yes 
Segments of the RAID: 


Segment Name Device Size Sectors 
0 clus134.msbd0 sdb 99.59MB 203968 
1 clus134.msbd1 sdc 99.59MB 203968 


Viewing Device Details 


You can use the nlvm list device «device name» command to view details about a specified 


Size-716.00MB(1466368) Used-32KB(64) Free-715.95MB(1466271) 


H:S=255:32 


Sync 
Yes 
Yes 


device on the system. For command usage information, see “List Device” in the OES 11 SP3: NLVM 


Reference. 


The command returns the following information: 


Device name 
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Device major:minor 

Size of device in MB, GB, or TB 

Free space remaining on the device in KB, MB, GB, or TB 

Partitioning format - MSDOS, GPT, CSM, LVM (meaning Clustered Linux LVM volume), None 
Geometry heads:sectors per track 

Shared - (Yes or No) Whether this device is marked as shared 

RAID — (Yes or No) Whether this is an NSS software RAID device 


For RAID devices, it provides the following information: 


Type - 0, 1, or 5 Software RAID type 

Segs — Number of segments that this RAID should have 
Missing — Segment number (if any) that is missing in the RAID 
Stripe — RAID stripe size in bytes (typically kilobytes) 

Enbl — (Yes or No) Whether the RAID is enabled on this node 
Sync - (1 or 0) Whether the RAID is in sync 

96 — Percent complete of remirror or restripe 


For RAID segments, it provides the following information: 


Segment index 

Segment (partition) name 

Device name of the segment 

Segment size 

Sync - (1 or 0) If this mirror segment is in sync 
96 — Percent this mirror segment is remirrored 


For a device's partitions, it provides the following information: 


Partition name 

Partition size 

Partition type 

Pool name if the partition is the NSS type and it contains a pool 


To view device details: 


1 Login to the server as the root user, then open a terminal console. 
2 View details about a device by entering 
nlvm list device «device name» 
For example: 
nlvm list device sde 
Name-sde 


Size=512.00MB (1048576) Used-16KB(32) Free-511.98MB (1048544) 
Format=MSDOS Shared-No RAID=No M:M=8:64 H:S=255:32 


7.4 Initializing a Device 


You must initialize a device to set up its device format before you can create volumes on it. You can 
also initialize a device to wipe its current structure and reconfigure it. Devices that you want to use for 
Linux POSIX volumes should be in an unshared state whether they are local or SAN devices. For 
command usage information, see “Init Device” in the OFS 11 SP3: NLVM Reference. 
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IMPORTANT: NLVM and NSSMU do not support using Linux software RAID devices and NSS 
software RAID devices with Linux POSIX file systems. You can use a hardware RAID device to 
achieve device fault tolerance for Linux POSIX volumes. 


Initializing a device formats it with an MSDOS or a GPT partitioning scheme. MSDOS supports 
devices up to 2 TB in size. GPT supports devices of any size. The default is MSDOS. If the device 
size is greater than 2 TB and the partitioning scheme is not specified, the default partitioning scheme 
of MSDOS applies, and the device size is truncated to 2 TB with the remainder as unusable space. 


WARNING: Initializing a device removes all partitions and data from the device. Do not initialize the 
device that contains the operating system. 


Devices that have never been initialized have a format of None. Devices that are being used for a 
Novell Cluster Services SBD (split brain detector) partition also have a format of None; however, you 
should not use the nlvm init command to remove an SBD partition. For information about removing 
an SBD partition, see “Creating or Deleting Cluster SBD Partitions” in the OES 11 SP3: Novell Cluster 
Services for Linux Administration Guide. 


1 Log in to the server as the root user, then open a terminal console. 


2 View a list of active devices by entering 


nlvm list devices 


3 Identify the device that you want to initialize. If a device is contains data, be prepared to lose all 
data on the device when you initialize it. 


In the following example, the saa and sde devices are uninitialized and display a format of None. 
The clus1.sbd device is a mirrored RAID device that is used for the SBD partition of a cluster 
named clus1. The SBD device should not be used. 


nivm list devices 


Name Size Used Free Format Shared RAID Enabled 
sda 11.00GB 9.29GB 1.70GB MSDOS No No 

sdb 102.00MB 102.00MB OKB MSDOS Yes No 

sdc 102.00MB 102.00MB OKB MSDOS Yes No 

sdd 512.00MB OKB OKB None No No 

sde 512.00MB OKB OKB None No No 
clus1.sbd 99.57MB 99.57MB OKB None Yes 1 Yes 


4 Initialize the device by entering 
nlvm [--force] [--no-prompt] init <device name> [format=<gpt|msdos>] unshared 


You are automatically prompted to confirm the initialize action. Enter yes to continue or enter no 
to cancel. Use the --no-prompt NLVM option to suppress the confirmation. 


Replace device_name with the node name of the device to be initialized, such as sde. The 
device name must be the first option after init. 


Specify gpt or msdos as the partitioning scheme to use when formatting the device. 


The unshared option removes all partitions from a device. If the device was previously set as 
shared, this removes the Shareable for Clustering setting from the device. 


For devices that contain data, specify the - -force option to force the initialization if the device 
contains the root (/), swap, or /boot partition, or if the init command cannot delete any pools 
on the disk. 


For example, to initialize a device with the MSDOS partitioning scheme and leave it as unshared, 
enter 


nlvm init sde format-msdos unshared 


Managing Linux Volumes with NLVM Commands 65 


66 


1.5 


7.6 


5 List details about the device to verify that the device is formatted, and the amount of free space 
has increased. 


nlvm list device <device_name> 


For example, enter 
nlvm list device sde 
Name-sde 


Size=512.00MB (1048576) Used-16KB(32) Free-511.98MB (1048544) 
Format=MSDOS Shared-No RAID=No M:M=8:64 H:S=255:32 


Unsharing a Device 


The sharing state of devices in NLVM is intended for marking devices as shareable that you plan to 
use for cluster-enabled NSS pools or for Novell Cluster Services SBD (split brain detector) partitions. 


For Linux volumes, you use devices that are not marked as shareable for clustering. When you 
cluster-enable an LVM volume group for Novell Cluster Services, clustered LVM controls the share 
state of the device, not the Shareable for Clustering setting. If a device was previously used for an 
NSS pool or SBD partition and reports a Shared state of Yes, it contains a small 4 KB partition to store 
the state. Before you can create a clustered LVM volume group on the device, you must change the 
device’s Shared state from Yes to No. 


You can use the nlvm unshare command to change the share state of a device. For command usage 
information, see “List Linux Volume” in the OES 11 SP3: NLVM Reference. 


1 Log in to the server as the root user, then open a terminal console. 
2 View a list of active devices by entering 
nlvm list devices 
3 Verify the device node name and share state of the device. 
4 Unshare the device by entering 
nlvm unshare sdd 
5 View a list of active devices by entering 
nlvm list devices 


6 Verify that the share state of the device has changed from Yes to No. 


Viewing a List of Linux Volumes 


You can use the nlvm list linux volumes command to view information about Linux POSIX and 
LVM logical volumes that are mounted on the system. For command usage information, see 
"Unshare" in the OES 11 SP3: NLVM Reference. 


1 Login to the server as the root user, then open a terminal console. 


2 View a list of active Linux volumes by entering 


nlvm list linux volumes 
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For example: 


nlvm list linux volumes 


Name Group Mounted Size Shared Type LVM NCP Mountpoint 

/ Yes 15.98GB No ext3 No No / 

/boot Yes 297.00MB No ext2 No No /boot 

/voli Yes 25.98GB No ext3 No No /mnt/voll 

VOL2 Yes 19.98GB No ext3 No Yes /mnt/VOL2 

lvmvol42 lvmvg42 Yes 508.00MB No xfs Yes No /mnt/vol42 

LVMVOL41 LVMVOL41 Yes 508.00MB No ext3 Yes Yes /usr/novell/LVMVOL41 
LVMVOL43 lvmvg43 Yes 508.00MB No xfs Yes Yes /mnt/vol43 


Creating a Non-LVM Linux Volume 


You can use the nlvm create linux volume command to create a native Linux POSIX volume ona 
device. You must have free unpartitioned space available on a device. For command usage 
information, see “Create Linux Volume” in the OES 11 SP3: NLVM Reference. 


1 Log in to the server as the root user, then open a terminal console. 


2 List the devices by entering the following command, then verify that the device that you want to 
use has been formatted. 


nlvm list device <device_name> 
Note the amount of free unpartitioned space available. 


3 To create the volume, enter 


nlvm create linux volume 
type=<btrfs|ext2|ext3|reiserfs|xfs> 
device=<device_name|anydisk> 
size-«value[K|M|G|T] |max> 
mp-«full mount point path» 
[mntopt-«fs mount options»] 
[ncp] 


Specify the type of file system to create on the volume. Valid values are btrfs,ext2, ext3, 
reiserfs, and xfs. 


Replace device name with the node name of the device where you want to create the volume, 
such as sda or sdd. You can also specify anydisk to use any unshared disk that has sufficient 
free unpartitioned space to create the volume. 


Specify the size of the partition to create for the Linux volume, or specify max to use all of the free 
unpartitioned space on the specified device. All sizes are in bytes and can be specified with one 
of the following multipliers: K (kilobytes), M (megabytes), G (gigabytes), or T (terabytes). 
Multipliers are case insensitive and are multiples of 1024. If no multiplier is specified, it is 
assumed to be G. If max is entered, all of the free unpartitioned space on the device is used. The 
minimum allowed size is 1 megabyte. 


Replace full_mount_point_path with the full Linux path where you want to mount the device. The 
last directory is assumed to be the name you want to give the volume. The name must be unique 
on the server. For example, /mnt/vol2. 


NOTE: If you enable NCP for the volume, the name of the final folder in the path must comply 
with the limitations for NCP volume names described in Section 5.4, “Naming Conventions for 
NCP Volume Names,” on page 31. If you use lowercase letters for the volume name, they are 
automatically changed to uppercase for the NCP volume name. 


Replace fs_mount_options with the mount options to use when mounting the volume. For a list 
of available options, see the mount (8) man page. The default mntopt value is rw. 
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Use the ncp option to enable the Linux POSIX file system on the volume to be accessed with the 
NetWare Control Protocol (NCP). It creates an NCP volume of the same name, and creates an 
NCP share at the root of the volume. 


For example, enter the following command to create a 20 GB NCP-enabled Linux POSIX volume 
named vo12 with the Ext3 file system that is mounted for read and write access at /mnt/vol1: 


nlvm create linux volume type=ext3 device-sda size=20G mp-/mnt/vol2 mntopt=rw 
ncp 


If the creation is successful, the response is: 


Volume mounted at /mnt/vol2 


4 Verify that the volume is mounted by entering 


nlvm list linux volumes 


For example: 
nlvm list linux volumes 
Name Group Mounted Size Shared Type LVM NCP Mountpoint 
/ Yes 15.98GB No ext3 No No / 
/boot Yes 297.00MB No ext2 No No /boot 
/home Yes 403.00GB No ext3 No No /home 
/voll Yes 25.98GB No ext3 No No /mnt/voll 
VOL2 Yes 19.98GB No ext3 No Yes /mnt/VOL2 


If NCP is enabled for the volume, the volume name appears in all uppercase, and the NCP value 
is Yes. 


7.8 Creating an LVM Logical Volume 


You can use the nlvm create linux volume command to create a Linux LVM volume group and 
logical volume, make a file system on the volume, and mount the volume. LVM requires a device that 
is unpartitioned and unshared. For command usage information, see “Create Linux Volume” in the 
OES 11 SP3: NLVM Reference. 


For conceptual information about LVM, see “Understanding the Logical Volume Manager” (http:// 
www.suse.com/documentation/sles11/stor_admin/data/sec_yast2_system_lvm_explanation.html) in 
the SUSE Linux Enterprise Server 11 SP3 Storage Administration Guide (http://www.suse.com/ 
documentation/sles11/stor_admin/data/bookinfo.html). 


1 Log in to the server as the root user, then open a terminal console. 


2 List the devices by entering the following command, then verify that the device that you want to 
use has been formatted. 


nlvm list device «device name> 


Note the amount of free unpartitioned space available. 
3 Tocreate the volume, enter 


nlvm create linux volume 
type=<btrfs|ext2|ext3|reiserfs|xfs> 
device=<devicename> 
size=<value[K|M|G|T] > 
mp-«full mount point path» 
[mntopt=<fs mount options»] 
lvm 
name-«lv name» 
[group-«vg name»] 
[ncp] 
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Specify the type of file system to create on the volume. Valid values are ext2, ext3, reiserfs, 
and xfs. 


Replace device_name with the node name of the device where you want to create the volume, 
such as sde. 


IMPORTANT: NLVM does not support using Linux software RAID devices and NSS software 
RAID devices with Linux POSIX file systems. You can use a hardware RAID device to achieve 
device fault tolerance for Linux POSIX volumes. 


Specify the size of the amount of free unpartitioned space on the device. All sizes are in bytes 
and can be specified with one of the following multipliers: K (kilobytes), M (megabytes), G 
(gigabytes), or T (terabytes). Multipliers are case insensitive and are multiples of 1024. If no 
multiplier is specified, it is assumed to be G. 


Replace full_mount_point_path with the full Linux path where you want to mount the device. The 
final directory’s name can be the same or different than the name that you assign to the logical 
volume. 


Replace fs_mount_options with the mount options to use when mounting the volume. For a list 
of available options, see the mount (8) man page. The default mntopt value is rw. 


Specify the 1vm option to create an LVM volume group and logical volume. 


Replace /v name with the name you want to give the LVM logical volume. 


NOTE: If you enable NCP for the volume, the LVM volume name must comply with the 
limitations for NCP volume names described in Section 5.4, "Naming Conventions for NCP 
Volume Names," on page 31. If you use lowercase letters for the volume name, they are 
automatically changed to uppercase for the NCP volume name. 


Replace vg name with the name you want to give the LVM volume group. If the group option is 
not used, the volume group uses the same name as the logical volume. 


Use the ncp option to enable the Linux POSIX file system on the volume to be accessed with the 
NetWare Control Protocol (NCP). It creates an NCP volume of the same name with all 
uppercase letters, and creates an NCP share at the root of the volume. 


For example, enter the following command to create an LVM volume group named 1vmvg42 and 
volume named 1vmvo142 with the XFS file system that is mounted for read and write access at / 
mnt /vol42: 


nlvm create linux volume type-xfs device-sde size-511M mp-/mnt/vol42 mntopt=rw 
lvm name=lvmvol42 group-lvmvg42 


If the creation is successful, the response is: 


Volume mounted at /mnt/vol42 


Verify that the volume is mounted by entering 


nlvm list linux volumes 


For example: 
nlvm list linux volumes 

Name Group Mounted Size Shared Type LVM NCP Mountpoint 

/ Yes 15.98GB No ext3 No No / 

/boot Yes 297.00MB No ext2 No No /boot 

lvmvol42 lvmvg42 Yes 508.00MB No xfs Yes No /mnt/vol42 

LVMVOL41 LVMVOL41 Yes 508.00MB No ext3 Yes Yes /usr/novell/LVMVOL41 
LVMVOL43 lvmvg43 Yes 508.00MB No xfs Yes Yes /mnt/vol43 
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If NCP is enabled for the volume, the volume name appears in all uppercase, and the NCP value 
is Yes. If the volume group name is not specified for an NCP-enabled LVM volume, the volume 
group name also appears in uppercase, as shown for LvMvoL41. For LVM volumes, the mount 
point path uses the mount point path as provided, as shown for volumes 1vmvol42 and 
LVMVOL43 the example. If no mount point path is provided, the default mount point /usr/ 
novell/«volume name» is used, such as /usr/novell/LVMVOL41. 


5 View information about the volume group you created by entering the following Linux LVM 
command: 


vgdisplay [vg name] 


For example: 


avalon:-/Desktop # vgdisplay 
--- Volume group --- 


VG Name lvmvg42 

System ID 

Format lvm2 

Metadata Areas 1 

Metadata Sequence No 2 

VG Access read/write 

VG Status resizable 

MAX LV o 

Cur LV 1 

Open LV l 

Max PV Oo 

Cur PV 1 

Act PV 1 

VG Size 508.00 MB 

PE Size 4.00 MB 

Total PE 127 

Alloc PE / Size 127 / 508.00 MB 
Free PE / Size 0/0 

VG UUID ASZE4n- AKM7-Ilbh-fBrf-sNSV-n61U-CSovSS 


7.9 Creating a Shared LVM Logical Volume with Novell 
Cluster Services 


For information about creating a clustered LVM volume group cluster resource with NLVM 
commands, see Section 8.3.3, "Creating an LVM Volume Group Cluster Resource with NLVM 
Commands,” on page 92 in Chapter 8, "Clustering LVM Volume Groups with Novell Cluster Services, 
on page 79. 


n 


7.10 Mounting Linux Volumes 


You can mount Linux volumes from the command line by using the nlvm linux mount command or 
by using the native Linux mount (8) command and ncpcon mount command (for NCP-enabled 
volumes). 
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7.10.1 


7.10.2 


IMPORTANT: If an LVM logical volume is clustered, you must use the cluster online command to 
allow the load script to mount the volume. You can also use the Cluster Manager page in the Clusters 
plug-in for iManager to bring a resource online. 


* Section 7.10.1, "Using the nlvm linux mount Command," on page 71 


+ Section 7.10.2, "Using the mount(8) and ncpcon mount Commands,” on page 71 


Using the nlvm linux mount Command 


You can use the nlvm linux mount command to mount Linux volumes. If the volume is NCP- 
enabled, the command mounts the volume in Linux and then automatically mounts the volume in 
NCP. It uses the mount options in the /etc/fstab file by default. You can optionally specify mount 
options available in the mount (8) command. See the mount (8) man page for information about the 
mount options for the volume's file system. 


1 Login to the server as the root user, then open a terminal console. 


2 View a list of Linux volumes by entering the following command, then find the name, mount 
point, and mount status of the volume you want to mount. 


nlvm list linux volumes 


For example, the following Linux POSIX volume's name is LVMNCP. It is not mounted. 


Name Group Mounted Size Shared Type LVM NCP Mountpoint 

/ Yes 15.98GB No ext3 No No / 

/home Yes 3.00GB No ext3 No No /home 

mylvm mylvm No 100.00MB No ext3 Yes No /usr/novell/mylvm 
LVMNCP lvmncp No 100.00MB No ext3 Yes Yes /usr/novell/lvmncp2 
NCP3 Yes 103.59MB No ext3 No Yes /usr/novell/NCP3 


3 Mount the volume by entering 


nlvm linux mount «1x volume name» [mntopt=[option1] [,option2][,...]] 


Use the name format as it is displayed in NSSMU or with the nlvm list volumes command, 


such as: 

LV VOL1 [ex: an LVM volume that is NCP-enabled] 

lv voll [ex: an LVM volume that is not NCP-enabled] 
HOME [ex: a non-LVM volume that is NCP-enabled] 
/home [ex: a non-LVM volume that is not NCP-enabled] 


For example, enter 
nlvm linux mount LVMNCP 


nlvm linux mount LVMNCP mntopt-rw,user xattr 


The first example uses the mount options in the /etc/fstab file. The second example uses the 
specified mount options. 


Using the mount(8) and ncpcon mount Commands 


You can also use the native Linux mount (8) command to mount Linux volumes. See the mount (8) 
man page for information about usage and the mount options for the volume's file system. 


1 Login to the server as the root user, then open a terminal console. 


2 View a list of Linux volumes by entering the following command, then find the name, mount 
point, and mount status of the volume you want to mount. 
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nivm list linux volumes 


For example, the following Linux POSIX volume’s name is LVMNcP. Its mount point is /usr/ 
novell/lvmncp2. It is not mounted. 


Name Group Mounted Size Shared Type LVM NCP Mountpoint 

/ Yes 15.98GB No ext3 No No / 

/home Yes 3.00GB No ext3 No No /home 

mylvm mylvm No 100.00MB No ext3 Yes No /usr/novell/mylvm 
LVMNCP lvmncp No 100.00MB No ext3 Yes Yes /usr/novell/lvmncp2 
NCP3 Yes 103.59MB No ext3 No Yes /usr/novell/NCP3 


3 Mount the volume by entering 
mount -t «fstype» «device name» «full mount point path» [-o option list] 


Replace fstype with the file system type of the volume. 


For a Linux POSIX volume, replace device name with the Linux path of the device. For an LVM 
volume, replace device name with the full device path of the logical volume, such as /dev/ 
«vg name»/«lv name». 


Replace full mount point path with the volume's mount point. 


For example, enter 


mount -t ext3 /dev/lvmncp/LVMNCP /usr/novell/lvmncp2 


mount -t ext3 /dev/lvmncp/LVMNCP /usr/novell/lvmncp2 -o rw,user xattr 


The first example uses the mount options in the /etc/fstab file. The second example uses the 
specified mount options. 


4 If the volume is NCP-enabled, mount the volume in NCP by entering 


ncpcon mount «NCP volume name» 


For example, enter 


ncpcon mount LVMNCP 


711 Dismounting Linux Volumes 


You can dismount Linux volumes from the command line by using the n1vm linux unmount 
command or by using the native Linux umount (8) command and ncpcon dismount command (for 
NCP-enabled volumes). 


IMPORTANT: If an LVM logical volume is clustered, you must use the Novell Cluster Services 
cluster offline command to allow the unload script to dismount the volume. You can also use the 
Cluster Manager page in the Clusters plug-in for iManager to take a resource offline. 


* Section 7.11.1, "Using the nlvm linux unmount Command," on page 73 


* Section 7.11.2, "Using the umount(8) and ncpcon dismount Commands," on page 73 


72 OES 11 SP3: Linux POSIX Volume Administration Guide 


7.11.1 


7.11.2 


Using the nlvm linux unmount Command 


You can use the nlvm linux unmount command to dismount Linux volumes. If the volume is NCP- 
enabled, the command automatically dismounts the volume in NCP before it dismounts the volume in 
Linux. 

1 Login to the server as the root user, then open a terminal console. 


2 View a list of Linux volumes by entering the following command, then find the name and mount 


status of the volume you want to dismount. 


nlvm list linux volumes 


For example, the Linux volume /home is mounted with a mount point of /home. The NCP- 
enabled Linux volume NCP3 is mounted with a mount point of /usr/novell/NCP3. 


Name Group Mounted Size Shared Type LVM NCP Mountpoint 

/ Yes 15.98GB No ext3 No No / 

/home Yes 3.00GB No ext3 No No /home 

mylvm mylvm No 100.00MB No ext3 Yes No /usr/novell/mylvm 
LVMNCP lvmncp No 100.00MB No ext3 Yes Yes /usr/novell/lvmncp2 
NCP3 Yes 103.59MB No ext3 No Yes /usr/novell/NCP3 


Dismount the volume by entering 


nlvm linux unmount «1x volume name» 


Use the name format as it is displayed in NSSMU or with the nlvm list volumes command, 
such as: 


LV VOL1 [ex: an LVM volume that is NCP-enabled] 

lv voll [ex: an LVM volume that is not NCP-enabled] 
HOME [ex: a non-LVM volume that is NCP-enabled] 
/home [ex: a non-LVM volume that is not NCP-enabled] 


For example, enter 
nlvm linux unmount /home 
nlvm linux unmount NCP3 


The first example dismounts the volume from Linux. The second example dismounts an NCP- 
enabled volume from NCP, and then dismounts it from Linux. 


Verify that the volume's Mounted status changed from Yes to No 


nlvm list linux volumes 


The volume is not mounted. For example: 


Name Group Mounted Size Shared Type LVM NCP Mountpoint 

/ Yes 15.98GB No ext3 No No / 

/home No 3.00GB No ext3 No No /home 

mylvm mylvm No 100.00MB No ext3 Yes No /usr/novell/mylvm 
LVMNCP lvmncp No 100.00MB No ext3 Yes Yes /usr/novell/lvmncp2 
NCP3 No 103.59MB No ext3 No Yes /usr/novell/NCP3 


Using the umount(8) and ncpcon dismount Commands 


You can use the native Linux umount (8) command to dismount Linux volumes. See the umount (8) 
man page for information about usage and the dismounting options for your file system. 


1 Login to the server as the root user, then open a terminal console. 


2 View a list of Linux volumes by entering the following command, then find the name, mount 


point, and mount status of the volume that you want to dismount. 
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nivm list linux volumes 


For example, the Linux volume /home is mounted with a mount point of /home. The NCP- 
enabled Linux volume NCP3 is mounted with a mount point of /usr/novell/NCP3. 


Name Group Mounted Size Shared Type LVM NCP Mountpoint 

/ Yes 15.98GB No ext3 No No / 

/home Yes 3.00GB No ext3 No No /home 

mylvm mylvm No 100.00MB No ext3 Yes No /usr/novell/mylvm 
LVMNCP lvmncp No 100.00MB No ext3 Yes Yes /usr/novell/lvmncp2 
NCP3 Yes 103.59MB No ext3 No Yes /usr/novell/NCP3 


3 If the volume is NCP enabled, dismount the volume from NCP Server. 
ncpcon dismount «ncp volume name» 
For example, enter 


ncpcon dismount NCP3 


4 Dismount the volume from Linux by entering the native Linux umount command: 


umount «full mount point path» 


Replace full mount point path with the volume's mount point. For example, enter 


umount /home 


umount /usr/novell/NCP3 
5 Verify that the volume's Mounted status changed from Yes to No by entering 
nlvm list linux volumes 


The volume is not mounted. For example: 


Name Group Mounted Size Shared Type LVM NCP Mountpoint 

/ Yes 15.98GB No ext3 No No / 

/home No 3.00GB No ext3 No No /home 

mylvm mylvm No 100.00MB No ext3 Yes No /usr/novell/mylvm 
LVMNCP lvmncp No 100.00MB No ext3 Yes Yes /usr/novell/lvmncp2 
NCP3 No 103.59MB No ext3 No Yes /usr/novell/NCP3 


7.2 Rescanning for Storage Objects on Known 
Devices 


You can use the nlvm rescan command to scan for storage objects (such as partitions, NSS pools, 
and NSS software RAIDs) on known devices. It creates and updates Device Mapper objects, and 
mounts pools as needed. Use the -m option if you do not want to automatically mount any unmounted 
pools. For command usage information, see "Rescan" in the OES 11 SP3: NLVM Reference. 

1 Login to the server as the root user, then open a terminal console. 


2 Rescan the system for storage objects by entering 


nlvm -m rescan 


The -m option causes it to not automatically mount any pools on the system. 


74 OES 11 SP3: Linux POSIX Volume Administration Guide 


7.13 


7.13.1 


Deleting a Linux POSIX Volume 


You can use the nlvm delete linux volume command to delete a Linux POSIX volume. The 


volume must be unmounted. For command usage information, see "Delete Linux Volume" in the OES 
11 SP3: NLVM Reference. 


WARNING: The delete process removes the partition for the volume, and destroys all of the data on 


the partition. 


* Section 7.13.1, "Deleting a Linux POSIX Volume," on page 75 


¢ Section 7.13.2, “Deleting an LVM Volume Group and Logical Volume,” on page 76 


Deleting a Linux POSIX Volume 


1 Login to the server as the root user, then open a terminal console. 


2 View a list of Linux volumes by entering the following command, then find the name, mount 


point, and mount status of the volume that you want to delete. 


nlvm list linux volumes 


For example, the following Linux POSIX volume's name is /vo11. Its mount point is /mnt /vol1. 


Its mount status is Mounted. 


nlvm list linux volumes 


Name 
/ 
/boot 
/home 
/voli 
VOL2 


Group Mounted 
Yes 
Yes 
Yes 
Yes 
Yes 


Size Shared 


.98GB 
. 00MB 
. 00GB 
. 98GB 
. 98GB 


No 
No 
No 
No 
No 


Type LVM NCP Mountpoint 
ext3 No No / 

ext2 No No /boot 

ext3 No No /home 

ext3 No No /mnt/voll 

ext3 No Yes /mnt/VOL2 


3 Dismount the volume by entering the native Linux umount command: 


umount «full mount point path» 


Replace full mount point path with the volume's mount point. For example, enter 


umount /mnt/voll 


4 Delete the Linux POSIX volume by entering 


nlvm [--no-prompt] delete linux volume «volume name» 


You are automatically prompted to confirm the delete action. Enter yes to continue or enter no to 
cancel. Use the - -no-prompt NLVM option to suppress the confirmation. 


For example, enter 


nlvm delete linux volume /voll 


5 Verify that the volume no longer appears in the list of Linux volumes by entering 


nlvm list linux volumes 


The volume does not appear in the list. 
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7.13.2 


nlvm list linux volumes 


Name Group Mounted Size Shared Type LVM NCP Mountpoint 
J Yes 15.98GB No ext3 No No / 

/boot Yes 297.00MB No ext2 No No /boot 
/home Yes 403.00GB No ext3 No No /home 

VOL2 Yes 19.98GB No ext3 No Yes /mnt/VOL2 


6 Verify that the space used by the volume's partition is now available as free unpartitioned space 
by entering 


nlvm list devices 


For example, see the Size, Used, and Free values for the device, such as for sda: 


nlvm list devices 


Name Size Used Free Format Shared RAID Enabled 
sda 11.00GB 9.29GB 1.70GB MSDOS No No 
sdb 102.00MB 102.00MB OKB MSDOS Yes No 
sdc 102.00MB 102.00MB OKB MSDOS Yes No 
sdd 512.00MB 16KB 511.98MB MSDOS No No 


Deleting an LVM Volume Group and Logical Volume 


Use the procedure in this section to delete an LVM volume group and logical volume. If the LVM 
volume group and logical volume are clustered with Novell Cluster Services, use the instructions in 
Section 8.10, “Deleting a Clustered LVM Volume Group and Logical Volume,” on page 110. 


1 Login to the server as the root user, then open a terminal console. 


2 View a list of Linux volumes by entering the following command, then find the name, mount 
point, and mount status of the volume that you want to delete. 


nlvm list linux volumes 


For example, the following LVM logical volume's name is 1vvol1. Its mount point is /mnt / 
lvvol1. Its mount status is Mounted. 


nlvm list linux volumes 


Name Group Mounted Size Shared Type LVM NCP Mountpoint 
/ Yes 15.98GB No ext3 No No / 

/boot Yes 297.00MB No ext2 No No /boot 

/home Yes 403.00GB No ext3 No No /home 
lvvoli Yes 25.98GB No ext3 No No /mnt/lvvoll 
VOL2 Yes 19.98GB No ext3 No Yes /mnt/VOL2 


3 Dismount the volume by entering the native Linux umount command: 


umount «full mount point path» 
Replace full mount point path with the volume's mount point. For example, enter 
umount /mnt/lvvoli 

4 Delete the LVM logical volume and its volume group by entering 


nlvm delete linux volume «lv name» 


You are automatically prompted to confirm the delete action. Enter yes to continue or enter no to 
cancel. Use the - -no-prompt NLVM option to suppress the confirmation. 


For example, enter 


nlvm delete linux volume lvvol1 


5 Verify that the volume no longer appears in the list of Linux volumes by entering 
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nlvm list linux volumes 


The volume does not appear in the list. 


nlvm list linux volumes 


Name 


/boot 
/home 


VOL2 


6 Verify that the LVM volume group is deleted by entering the native LVM vgdisplay command: 


vgdisplay 


Group Mounted Size Shared 


Yes 15.98GB No 
Yes 297.00MB No 
Yes 403.00GB No 
Yes 19.98GB No 


Type LVM 
ext3 No 
ext2 No 
ext3 No 
ext3 No 


NCP Mountpoint 
No / 

No /boot 

No /home 

Yes /mnt/VOL2 


7 Verify that the space used by the volume group's partition is now available as free unpartitioned 
space by entering 


nlvm list devices 


For example, see the Size, Used, and Free values for the device, such as for sda: 


nlvm list devices 


Name 
sda 
sdb 
sdc 
sdd 


Size Used Free 
11.00GB 9.29GB 1.70GB 
102.00MB 102.00MB OKB 
102.00MB 102.00MB OKB 
512.00MB 16KB 511.98MB 


7.14 Additional Information 


For information about native LVM commands and YaST 2 tools to create and manage LVM volume 


Format 
MSDOS 
MSDOS 
MSDOS 
MSDOS 


groups and logical volumes, see the following resources: 


* “Linux LVM Management Tools” in the OES 11 SP3: Novell Cluster Services for Linux 


Administration Guide 


+ “LVM Configuration" (http://www.suse.com/documentation/sles11/stor admin/data/Ivm.html) in 


Shared RAID Enabled 


No 


Yes 
Yes 


No 


No 
No 
No 
No 


the SUSE Linux Enterprise Server 11 SP3 Storage Administration Guide (http://www.suse.com/ 
documentation/sles11/stor admin/data/bookinfo.html) 
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8.1 


Clustering LVM Volume Groups with 
Novell Cluster Services 


After you have installed and configured Novell Cluster Services, you can create shared cluster 
resources for Linux Logical Volume Manager (LVM) volume groups. You create an LVM logical 
volume on the volume group, and add a Linux POSIX file system such as Btrfs, Ext2, Ext3, ReiserFS, 
or XFS. 


You can enable NCP for the volume to enable the Linux volume to be accessed with the NetWare 
Core Protocol. An NCP volume of the same name is automatically created, and the NCP share is 
created at the root of the volume. It also creates the NCP Virtual Server object for cluster resource in 
NetIQ eDirectory. 


This section describes how to configure the LVM volume group cluster resource, logical volume, and 
file system with NSSMU. 

¢ Section 8.1, “Requirements for Creating LVM Cluster Resources,” on page 79 

+ Section 8.2, “Initializing a SAN Device,” on page 83 


+ Section 8.3, “Configuring an LVM Volume Group Cluster Resource with NSS Management 
Tools,” on page 85 


* Section 8.4, “Configuring the LVM Cluster Resource Settings,” on page 95 

+ Section 8.5, "Viewing or Modifying the LVM Resource Scripts," on page 98 

* Section 8.6, “Sample LVM Resource Scripts,” on page 100 

* Section 8.7, “Renaming the Mount Point Path for a Clustered LVM Volume,” on page 105 

* Section 8.8, “Renaming a Clustered LVM Logical Volume,” on page 106 

* Section 8.9, “Disabling Clustering for an LVM Volume,” on page 108 

+ Section 8.10, “Deleting a Clustered LVM Volume Group and Logical Volume,” on page 110 

+ Section 8.11, “Deleting a Clustered LVM Volume (Created in NSSMU or NLVM),” on page 114 


Requirements for Creating LVM Cluster Resources 


Your system must meet the requirements in this section in addition to the cluster requirements 
described in “Planning for Novell Cluster Services” in the OES 11 SP3: Novell Cluster Services for 
Linux Administration Guide. 

¢ Section 8.1.1, “Novell Cluster Services,” on page 80 

* Section 8.1.2, "Linux Logical Volume Manager 2 (LVM2),” on page 80 

¢ Section 8.1.3, “Clustered Logical Volume Manager Daemon (CLVMD),” on page 80 

* Section 8.1.4, "Resource IP Address,” on page 80 

* Section 8.1.5, "Shared Storage Devices," on page 80 

+ Section 8.1.6, “All Nodes Must Be Present,” on page 81 

* Section 8.1.7, "Working in Mixed Node OES Clusters," on page 81 

+ Section 8.1.8, “NCP File Access with Novell NCP Server,” on page 81 
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* Section 8.1.9, “SMB/CIFS File Access with Novell Samba,” on page 82 
* Section 8.1.10, "Linux File Access Protocols,” on page 83 


8.1.1 Novell Cluster Services 


Novell Cluster Services must be installed, configured, and running when you create and manage the 
shared LVM volume group and logical volume. The cluster must be active. 


8.12 Linux Logical Volume Manager 2 (LVM2) 


The Linux Logical Volume Manager (LVM) 2 software supports LVM volume groups and logical 
volumes. LVM2 must be installed and running on each node in the cluster. LVM2 runs automatically 
on OES 11 and later servers; no separate installation or setup is required. 


8.13 Clustered Logical Volume Manager Daemon (CLVMD) 


The Linux Clustered Volume Manager Daemon (CLVMD, clvmd) software allows you to exclusively 
mount a shared LVM volume group on one node at a time in a cluster. It distributes the LVM metadata 
updates around a cluster. CLVM must be installed and running on each node in the cluster. CLVMD 
runs automatically on OES 11 and later servers; no separate installation or setup is required. 


IMPORTANT: Ensure that you have installed the latest patches for SUSE Linux Enterprise Server 11 
SP1 and later. Clustered LVM volume groups require Linux kernel version 2.6.32.45-0.3 or later. 


CLVM requires that shared LUNs that you use for clustered LVM devices be allocated to every node 
in the cluster. It is not supported to allocate a shared LUN to only selected nodes in the cluster. 


8.1.4 Resource IP Address 


Each cluster resource requires a unique static IP address that is in the same subnet as the IP 
addresses that are used for the cluster and cluster nodes. The IP address is used to provide access 
and failover capability for the cluster-enabled volume. 


8.15 Shared Storage Devices 


The shared SAN storage device that you use for an LVM volume group cluster resource must be 
initialized and have no partitions on it. When the device is used in a cluster resource, L VM uses the 
entire device for the volume group. Ensure that you size your LUNs accordingly. Use the SAN 
management tools to assign the LUN to all nodes in the cluster. 


IMPORTANT: If you use NSS management tools to manage devices, do not enable the Shareable for 
Clustering option. Doing so adds a 4 KB partition to the device, which makes it unavailable to L VM. 
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8.1.6 


8.1.7 


8.1.8 


All Nodes Must Be Present 


LVM requires the presence of all the nodes in the cluster to modify the metadata on shared storage. 
This allows LVM to get the exclusive locks it needs to perform actions on shared storage. 


Before you attempt to create or modify LVM volume group cluster resources: 


¢ All of the nodes must be joined in the cluster and running properly. 


* The clvmd daemon must be running on all nodes. 


Working in Mixed Node OES Clusters 


LVM volume group cluster resources are not supported in mixed-node OES clusters when you 
upgrade from OES 2 SP3 to OES 11 (or later). Complete the upgrade before you create new cluster 
resources. 


NCP File Access with Novell NCP Server 


Novell NCP Server can be used to provide NCP file access to Linux POSIX file systems on OES 11 
and later servers. Its NCP volumes feature can be used to provide NCP access to files on an LVM 
volume group cluster resource. NCP Server must be installed, configured, and running on each node 
in the cluster. 


* "Naming Conventions for NCP Volumes" on page 81 
* "Creating an NCP Volume for a New Clustered LVM Volume" on page 81 
* "Creating an NCP Volume on an Existing Clustered LVM Volume" on page 82 


* "Using Antivirus Software with NCP Volumes" on page 82 


Naming Conventions for NCP Volumes 


NCP volume names can be up to 14 alphanumeric characters, using uppercase letters A through Z 
and numbers 0 through 9. Underscores ( ) are allowed. 


If you NCP enable a Linux volume as you create it with NSSMU or the n1vm create linux volume 
command, the NCP volume name uses the specified Linux volume name, but all letters are 
capitalized. NCP treats the Linux volume name as case insensitive. Ensure that the specified Linux 
volume name does not exceed 14 characters, does not use special characters, and is unique across 
all nodes in the cluster for both Linux and NCP. 


Creating an NCP Volume for a New Clustered LVM Volume 


You can configure NCP file access for an LVM volume group cluster resource when you create the 
resource by using NSSMU or the nlvm create linux volume command. With the NCP option 
enabled, these tools automatically add commands to the resource scripts that mount, dismount, and 
monitor an NCP volume. The NCP volume is named the same as the LVM logical volume name, and 
all letters in the name are capitalized. The tools automatically create an NCP Virtual Server object for 
the volume group cluster resource. 
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Creating an NCP Volume on an Existing Clustered LVM Volume 


You can create an NCP Virtual Server object for the LVM cluster resource to make the resource 
visible in the eDirectory tree. The virtual server alone does not provide NCP file access. 


You can add NCP file access support to an existing LVM cluster resource: 


1. Create an NCP Virtual Server object for the LVM cluster resource. 


2. Create the NCP volume at the mount point path for the Linux volume. You can also create 
shares at subdirectories on the volume. This creates an NCP Volume object. 


3. Modify the NCP configuration file to comment out the instance for the NCP volume. This allows 
the LVM cluster resource to control mounts and dismounts for the NCP volume. 


4. Modify the LVM cluster resource scripts to add commands that define, mount, dismount, and 
monitor the NCP volume. 


5. Take the resource offline, then bring it online to apply the changes. 


For details about setting up NCP volumes on an existing clustered Linux volume, see “Configuring 
NCP Volumes with Novell Cluster Services” in the OES 11 SP3: NCP Server for Linux Administration 
Guide. 


Using Antivirus Software with NCP Volumes 


For information about using antivirus software with NCP volumes, see “McAfee Antivirus Requires 
Additional Configuration” in the OES 11 SP3: Planning and Implementation Guide. 


8.1.9  SMBICIFS File Access with Novell Samba 


Samba is an open source software suite that lets Linux and other non-Windows servers provide file 
and print services to clients that support the Microsoft SMB (Server Message Block) and CIFS 
(Common Internet File System) protocols. Novell Samba is the Linux Samba software that has been 
modified to work with NetIQ eDirectory. Novell Samba can be used to provide SMB/CIFS access to 
files on native Linux file systems and Novell Storage Services (NSS) file systems. Users must be 
eDirectory users who are enabled for Linux User Management (LUM). For information about LUM- 
enabling your eDirectory users, see the OES 11 SP3: Novell Linux User Management Administration 
Guide. 


IMPORTANT: Novell Samba cannot be used on OES servers where Novell CIFS is installed. Novell 
CIFS supports only NSS file systems. 


Novell Samba must be installed and configured on each node in the cluster. The cluster load script 
starts the service when you online the Samba cluster resource, and the unload script stops the 
service when you offline it. For information about using the Samba resource template to create a 
Samba cluster resource that is based on an LVM volume group, see “Configuring Samba for LVM 
Volume Groups and Novell Cluster Services” in the OES 11 SP3: Novell Samba Administration 
Guide. 


IMPORTANT: If you enable both NCP and Novell Samba file access for users, we recommend that 
you enable the Cross-Protocol Lock (CPL) parameter for NCP Server. CPL helps prevent potential 
data corruption when files are accessed by non-NCP file access protocols and by other applications 
that directly access the files with POSIX APIs. CPL is enabled by default. For information, see 
"Configuring Cross-Protocol File Locks for NCP Server' in the OES 11 SP3: NCP Server for Linux 
Administration Guide. 
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8.1.10 


8.2 


Linux File Access Protocols 


You can provide native Linux file access to files on an LVM volume group cluster resource for 
eDirectory users who are enabled for Linux User Management (LUM). The Linux file access protocols 
must also be LUM enabled on each node of the cluster. For information about LUM-enabling your 
eDirectory users and native Linux file access protocols, see the OES 11 SP3: Novell Linux User 
Management Administration Guide. 


Initializing a SAN Device 


Before you begin, you must initialize the SAN device to set up its device format. You can also initialize 
a device to wipe its current structure and reconfigure it. 


WARNING: Initializing a device removes all partitions and data from the device. Do not initialize the 
device that contains the operating system. 


Devices that you want to use for a clustered Linux LVM volume group should contain no partitions 
and be in an unshared state. When you initialize the SAN device by using NSS management tools, 
ensure that the Shareable for Clustering option is disabled. 


IMPORTANT: NLVM and NSSMU do not support using Linux software RAID devices and NSS 
software RAID devices with Linux POSIX file systems. You can use a hardware RAID device to 
achieve device fault tolerance for Linux POSIX volumes. 


Initializing a device formats it with an MSDOS or a GPT partitioning scheme. MSDOS supports 
devices up to 2 TB in size. GPT supports devices of any size. The default is MSDOS. If the device 
size is greater than 2 TB and the partitioning scheme is not specified, the default partitioning scheme 
of MSDOS applies, and the device size is truncated to 2 TB with the remainder as unusable space. 


Devices that have never been initialized have a format of None (NLVM commands) or Uninitialized 
(in NSSMU). Devices that are being used for a Novell Cluster Services SBD (split brain detector) 
partition also have a format of None; however, you should not use the nlvm init command to 
remove an SBD partition. For information about removing an SBD partition, see "Creating or Deleting 
Cluster SBD Partitions" in the OES 11 SP3: Novell Cluster Services for Linux Administration Guide. 


Use the procedure in this section to initialize the SAN device that you want to use for the LVM volume 
group. Do not mark it as shareable for clustering. 


1 Ensure that the SAN device is attached to all of the nodes in the cluster. 
2 Login to the master node of the cluster as the root user, then open a terminal console. 
3 Launch NSSMU: 

nssmu 


4 In the NSSMU main menu, select Devices, then press Enter. 


Main Menu 


Devices 
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5 In the Devices list, select the SAN device (such as sdf), then view information about it. 


A device that has never been initialized reports a partition type of Uninitialized. If the device 
contains partitions or data, be prepared to lose all data on the device when it is initialized. The 
clustered volume group requires the entire device. 


Device Informatior 


Uninitialized 
No 


Sharable for Clustering: No 


FS-Init FS-Refresh F6=Share SPACE-Sel 


6 Press F3 to initialize the selected device. 


You are prompted to confirm the initialization. If you continue, any existing partitions on the 
device are deleted, and a new partition table is created. 


7 Read the advisory message, then do one of the following: 
* Press y (Yes) to confirm that you want to initialize the device, and continue to Step 8. 
* Press n (No) (or press Esc) to cancel. Return to Step 5 and choose a different device. 
8 Specify the partitioning scheme to use as DOS or GPT, then press Enter. 
DOS supports devices up to 2 TB in size. GPT supports devices of any size. 
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9 Select the device and view its details to verify that the device is initialized and unshared (that is, 
Shareable for Clustering is set to No.) If Shareable for Clustering is set to Yes, press F6 to 
unshare the device. This is necessary to make the entire device available to Clustered LVM. 


F3-Init F5=Refresh F6=Share SPACE=Select/Unselect F8=More 


10 Press Esc twice to exit NSSMU. 


Configuring an LVM Volume Group Cluster 
Resource with NSS Management Tools 


This section describes how to use the NSSMU utility and NLVM commands to create a clustered LVM 
volume group and logical volume on a single SAN device that is assigned to all nodes in the cluster. 
The volume is exclusively mounted on only one node at a time. Clustered LVM manages the locks for 
the exclusive mount. 


After you create the resource, you should view and modify the cluster resource settings and scripts 
before you bring the resource online. You can also add lines to its load script, unload script, and 
monitor script to customize the resource for other uses. 


If you enable NCP when you create the volume, commands are automatically added to the resource 
scripts to mount, dismount, and monitor an NCP volume. The NCP volume is named the same as the 
LVM logical volume name, and all letters in the name are capitalized. An NCP Virtual Server object is 
created for the resource and commands are added to the scripts to bind or unbind it with the resource 
IP address. 

¢ Section 8.3.1, “Sample Values,” on page 86 

+ Section 8.3.2, “Creating an LVM Volume Group Cluster Resource with NSSMU,” on page 87 

¢ Section 8.3.3, “Creating an LVM Volume Group Cluster Resource with NLVM Commands,” on 

page 92 


For information about adding NCP file access to an existing volume, see the following sections in the 
OES 11 SP3: Novell Cluster Services for Linux Administration Guide: 


* "Creating a Virtual Server Object for an LVM Volume Group Cluster Resource” 
* “Enabling NCP File Access for a Clustered LVM Volume" 


Clustering LVM Volume Groups with Novell Cluster Services 85 


8.3.1 Sample Values 


The configuration scenarios use following sample values. Ensure that you replace the sample values 
with information for your configuration. 


Parameter Sample Value 
Device name for the shared SAN device /dev/sdf 


The device is initialized and contains no partitions. It is not enabled 
as shareable for clustering. 


Volume group name vol44 


By default, NSSMU uses the logical volume name as the LVM 
volume group name. If you use the NLVM create linux volume 
command to create the LVM volume group cluster resource, you 
can specify a different name for the volume group, such as vg44. 


Volume name vol44 


NCP volume name VOL44 


The NCP volume is created only if you enable NCP as you create 
the clustered LVM volume by using NSSMU or the NLVM create 
linux volume command. 


The mount point path for the NCP volume is the mount point for the 
LVM volume. This means that the NCP share is created at the root 
of the mounted LVM volume when the LVM resource is online. 


Linux POSIX file system type ext3 


Valid values are btrfs (requires the btrf sprogs package), ext2, 
ext3, reiserfs, and xfs. 


Make options for the file system None (do not specify a value). Press Enter to continue. 


For a list of the supported file system options for the file system type 
you are making, see the mk£s (8) man page and the man page for 
the specific file system: mk£s.btrfs(8),mkfs.ext2(8), 
mkfs.ext3(8),mkfs.reiserfs(8),ormkfs.xfs(8). 


IMPORTANT: The file system creation fails if you specify a make 
option that is not supported by the file system type. 


Mount options rw 


The Read/Write (rw) option is specified by default. For a list of 
available options that work with the file system type you are using, 
see the mount (8) man page. 


Volume size 100 GB 


A 100 GB LUN is prepared in the shared storage subsystem. It is 
attached to the nodes in the cluster. The device must be initialized 
and contain no partitions. It should not be marked as Shareable for 
clustering. 


You are not prompted to enter a volume size. The clustered LVM 
volume group and logical volume use the entire device. When you 
select the device, all of the device’s free available space is 
displayed in the Free Size field. 
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Parameter Sample Value 


Resource IP address 10.10.10.44 


This is the IP address of the virtual server for the cluster resource. 
The address must be unique and in the same subnet as the cluster’s 
IP address. Specify the IP address in IPv4 format. 


Mount device /dev/vol44/vol44 
The mount device path format is 
/dev/<volume_group_name>/<logical_volume_name> 


If you specify a different name for the volume group, such as vg44, 
by using the NLVM create linux volume command, the mount 
device path is /dev/vg44/vo144. 


Mount point path /mnt/vol44 


You can use any valid Linux path as the mount point. The default 
mount point location for LVM logical volumes created by NSSMU 
and NLVM is /usr/novell/<1lx volume name». 


NSSMU automatically creates the mount point path if it does not 
exist on this node. However, you must manually create the mount 
point on each of the other nodes in the cluster. If the path does not 
exist on a node when you fail over the resource to it, the resource 
goes comatose You can alternatively add the following line to the 
load script before the Linux file system mount command to create 
the path on a node if it does not exist: 


ignore error mkdir -p $MOUNT PATH 


8.3.2 Creating an LVM Volume Group Cluster Resource with 
NSSMU 


This section describes how to use NSSMU to create and cluster-enable an LVM volume group. 
NSSMU automatically uses the same script format as the Generic File System template 
(Generic FS Template) to create an LVM volume group cluster resource. 

1 Login to the master node of the cluster as the root user, then open a terminal console. 


2 If you have not already done so, initialize the SAN device that you want to use for the LVM 
volume group. 


For information, see Section 8.2, “Initializing a SAN Device,” on page 83. 
3 Launch NSSMU: 


nssmu 
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4 Inthe NSSMU main menu, select Linux Volumes, then press Enter. 


5 On the Linux Volumes page, press /nsert to launch the volume creation wizard, then enter the 
following information as you are prompted for it: 


Parameter 


Select LVM type 


Action 


Select Cluster Enabled LVM2 Volume, then press Enter. 


) 


LV L 
Cluster Enabled LVM2 Volume 


NCP Enable volume? 


Specify whether to enable the LVM logical volume for NCP file access. Press y 
(yes) to allow NCP file access, or press n (No) to disallow NCP file access at this 
time. 


If you enable NCP, NSSMU automatically adds commands to the resource scripts 
that mount, dismount, and monitor an NCP volume. The NCP volume is named 
the same as the LVM logical volume name, and all letters in the name are 
capitalized. The tools automatically create an NCP Virtual Server object for the 
resource. 


If you do not enable NCP at this time, you can manually create a virtual server 
and add NCP file access later. For information, see “Creating a Virtual Server 
Object for an LVM Volume Group Cluster Resource” in the OES 11 SP3: Novell 
Cluster Services for Linux Administration Guide. 


Enter volume name 


Type the name for the LVM logical volume (such as vo144), then press Enter. 


Enter volume name: vol44lj 


The specified name is also used for the LVM volume group, which is used in the 
name of the LVM volume group cluster resource. 


If you enable NCP for the volume, the specified name is also applied to the NCP 
volume. An NCP volume name can be up to 14 alphanumeric characters. 
Underscores are allowed. All letters in the LVM volume name are capitalized for 
the NCP volume name. For example, if the LVM volume name is vo144, the NCP 
volume name is VOL44. 
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Parameter 


Enter volume IP address 


Action 


Type the IP address to use for the LVM cluster resource in IPv4 format (such as 
10.10.10.44), then press Enter. 


Enter volume ip address: 10.10.10.44]l 


Select Volume type 


Select one of the following the Linux POSIX file systems, then press Enter: 
+ btrfs 
This option is displayed only if the btrfsprogs package is installed. 
* ext2 
* ext3 
* resiserfs 


* xfs 


If btrfsprogs is installed, five file system options are displayed: 


If btr£sprogs is not installed, four file system options are displayed: 


Enter full mount point path 


Type the full mount point path for the LVM logical volume (such as /mnt /vo144), 
then press Enter. 


Enter full mountpoint path: Us r /n« 


The default path is /usr/novell/«lx volume name», such as /usr/ 
novell/vol44. 


If NCP is enabled, the specified path is also used as the mount point path for the 
NCP volume. 
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Parameter 


Enter any make options 


Action 


Press Enter to continue without specifying options, or specify the desired make 
options for the file system type you are making, then press Enter. 


Enter any make options: 


For a list of the supported file system options for the file system type you are 
making, see the mkfs (8) man page and the man page for the specific file 
system: mkfs.btrfs(8),mkfs.ext2(8),mkfs.ext3 (8), 
mkfs.reiserfs(8),ormkfs.xfs(8). 


IMPORTANT: The file system creation fails if you specify a make option that is 
not supported by the file system type. 


Enter any mount options Press Enter to accept the default read and write options (rw). 
E y EN opti n Bu 
The Read/Write (rw) option is specified by default. You can add other mount 
options, or modify this option. For a list of available options that work with the file 
system type you are using, see the mount (8) man page. 
Device From the list of available devices, select the device that you initialized in 


Section 8.2, “Initializing a SAN Device,” on page 83, such as sdf, then press 
Insert or Enter to select the device. 


You can select an unshared initialized device, a shared device with no data 
partitions, or an uninitialized device. Only qualified devices are available in the 
list. For OES 11 SP1 and earlier, the device must already be initialized, contain 
no partitions, and must not be marked as shareable for clustering. 


The LVM volume group requires the entire device. You cannot specify the amount 
of space to use. The device's free available space is displayed in the Free Size 
field. 


Ins/ENTER-Select Del-Remove SN Select list U-Up D-Down ESC/Q=Prev Menu 


6 Press F3 to accept the setup you entered for the volume group cluster resource. 
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The resource is created and brought online on the node where you created it. The resource is 
named «volume group name» reference. In the example, the name of the volume group is the 
same as the logical volume, so the reference name is vol44_reference. 


7 Inthe Linux Volumes list, select the newly created volume and view information about it. 


Linux Volumes Volume Informatior 


Size: 
Mounted: 

State: 

LVM: = 

NCP: Not Enabled 


Share State: Sharable for Clustering 


Ins=Create Del=Delete F3=Rename FS=Refresh F7=Mount/Dismount ESC-Exit 


Parameter Description 
Device Specifies the full device node path for the LVM logical volume. 
Example: /dev/vol44/vol44 


Mount Point When the resource is online, this specifies the path on the root file system 
where this volume is mounted. 


Examples: /mnt/vol44 


Mount options When the resource is online, this specifies the mount options that are applied 
whenever this volume is automatically mounted after a reboot. 


Example: rw 


Type When the resource is online, this specifies the file system type. 


Examples: btrfs, ext2, ext3, reiserfs, xfs 


Size Specifies the amount of space reserved for this volume. 


Example: 99.58 GB 


Mounted Specifies whether the volume is mounted or unmounted. When the resource is 
brought online, the load script mounts the logical volume. 


Value: Yes or No 


State Specifies the availability for the file system. 


Example: Read/Write 


LVM Specifies whether the specified volume is an LVM logical volume. 


Value: Yes 
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Parameter Description 


NCP Specifies whether the LVM logical volume is enabled for NCP (yes or no). 


The NCP state cannot be determined for a clustered LVM volume. You can use 
the Clusters plug-in for iManager to determine if there are NCP commands in 
the load script. On the Cluster Options page, select the resource to view its 
properties, then click the Scripts tab. 


Share State Specifies whether the LVM logical volume is cluster enabled for a Novell 
Cluster Services cluster. 


Value: Shareable for Clustering 


8 Press Escape twice to exit NSSMU. 
9 Continue with Section 8.4, “Configuring the LVM Cluster Resource Settings,” on page 95. 


Creating an LVM Volume Group Cluster Resource with 
NLVM Commands 


This section describes how to use NLVM commands to create and cluster-enable an LVM volume 
group. NLVM automatically uses the same script format as the Generic File System template 
(Generic FS Template) to create an LVM volume group cluster resource. The NLVM command 
allows you to specify a group name that is different than the volume name. 


1 Log in to the master node of the cluster as the root user, then open a terminal console. 


2 Initialize the SAN device that you want to use for the LVM volume group. 


You can specify an unshared initialized device, a shared device with no data partitions, or an 
uninitialized device. For OES 11 SP1 and earlier, the device must already be initialized, contain 
no partitions, and must not be marked as shareable for clustering. 


Ensure that the SAN device is assigned to all nodes in the cluster. The device must contain no 
partitions and must not be marked as shareable for clustering. 


WARNING: Initializing a device removes all of the data on it. 


At the command prompt, enter 


nlvm [--force] [--no-prompt] init «device name» format=<gpt|msdos> unshared 


Replace device_name with the device node name of the device to be initialized, such as sdf. 
This must be the first command option to follow init. 


Specify the partitioning scheme as gpt or msdos. The default is msdos. The MSDOS partitioning 
scheme supports device sizes that are less than or equal to 2 TB. If the device size is greater 
than 2 TB and the partitioning scheme is not specified, the default partitioning scheme of 
MSDOS applies, and the device size is truncated to 2 TB with the remainder as unusable space. 
Devices of any size can be set to use the GPT partitioning scheme. 


Specify the unshared option to ensure that the device is not marked as shareable for clustering. 
You can specify the - -£orce NLVM option to force the initialization. 


You are automatically prompted to confirm the initialize action. Respond y (Yes) or n (No). Use 
the - -no-prompt NLVM option to suppress the confirmation. 


For example, enter 


nlvm init sdf format-gpt unshared 
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3 Create a clustered LVM volume group and logical volume. At the command prompt, enter the 
following (all on the same line, of course): 


nlvm [nlvm options] create linux volume 
type=<btrfs|ext2|ext3|reiserfs|xfs> 
device=<device_name> 
[mp=</mount_path>] 


[mkopt=<optionl[,option2,...]>] 
[mntopt=<optionl [option2[]...]>] 
lvm 


name=<lvm volume name» 

[group-«lvm group name»] 

shared 

ip-«IP address for LVM volgroup cluster resource» 
[ncp] 


For details about using this command, see “Create Linux Volume” in the OES 11 SP3: NLVM 
Reference. 


Parameters and Options 
type=<btrfs|ext2|ext3|reiserfs|xfs> 


You must specify the type of file system to use for the volume. Btrfs requires that the 


btrfsprogs package is installed on all nodes. Supported file systems are btrfs, ext2, ext3, 


reiserfs, and xfs. 
device=<device_name> 


You must specify the device to use. Replace device_name with the device node name of 
the device that you want to use for the volume, such as sdf. The entire device is used for 
the LVM volume group. You cannot specify a size to use. You can specify an unshared 
initialized device, a shared device with no data partitions, or an uninitialized device. For 
OES 11 SP1 and earlier, the device must already be initialized, contain no partitions, and 
must not be marked as shareable for clustering. 


[mp=</mount_path>] 


If a mount point path is not specified, the utility assigns a default mount path of /usr/ 
novell/«volume name». Use the mp option to specify a custom mount point. Replace 


mount path with the full Linux path of the mount point where the volume is to be mounted. 
The final directory name in the path can be the same or different than the specified volume 
name. If the path does not currently exist, it is automatically created on that node. You must 


manually create the path on other nodes in the cluster. 
[mkopt=<option1[,option2,...]>] 


You can use the mkopt option to specify the options to use when running mkfs. For a list of 
available options, see the mkfs (8) man page. No default option is specified. For a list of the 
supported file system options for the file system type you are making, see the mkfs (8) man 


page and the man page for the specific file system: mkfs.btrfs (8), mkfs.ext2 (8), 
mkfs.ext3 (8), mkfs.reiserfs(8), Of mkfs.xfs(8). 


IMPORTANT: The file system creation fails if you specify a make option that is not 
supported by the file system type. 


[mntopt=<option1[option2[]...]>] 


You can use the mntopt option to specify the options to use when mounting the volume. For 


a list of available options, see the mount (8) man page. The default mntopt value is rw 
(Read/Write). 


Ivm 


You must specify the 1vm option to create an LVM volume group and logical volume. Use 
this option with the name option. 
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name=</vm_volume_name> 


Replace /vm volume name with a name for the LVM volume. If you do not specify the 
group Option, this name is also used as the LVM volume group name, which is used in the 
cluster resource name. For LVM logical volume naming conventions, see "Linux LVM 
Volume Group and Logical Volume Names" in the OES 11 SP3: NLVM Reference. 


NOTE: If you enable NCP for the volume, the LVM volume name must comply with the 
limitations for NCP volume names described in Section 5.4, "Naming Conventions for NCP 
Volume Names," on page 31. If you use lowercase letters for the volume name, they are 
automatically changed to uppercase for the NCP volume name. 


[group-«/|vm group name?] 


Replace /vm volume group name with a name for the LVM volume group. The group 
name is also used in the cluster resource name. If you do not specify a volume group name, 
the group is automatically named the same as the LVM volume. 


shared 


You must specify the shared option to create a clustered LVM volume group and logical 
volume. 


ip-«IP address for LVM volgroup cluster resource» 


Replace /P. address for LVM volgroup cluster resource with a static unique IP address 
to use for the LVM cluster resource. Specify the address in IPv4 format. 


ncp 
Specify the ncp option to NCP enable the LVM logical volume for NCP file access. 


* |f you enable NCP, NSSMU automatically adds commands to the resource scripts that 
mount, dismount, and monitor an NCP volume. The NCP volume is named the same 
as the LVM logical volume name, and all letters in the name are capitalized. The tools 
automatically create an NCP Virtual Server object for the resource. 


* |f you do not enable NCP at this time, you can manually create a virtual server and add 
NCP file access later. For information, see "Creating a Virtual Server Object for an LVM 
Volume Group Cluster Resource" in the OES 11 SP3: Novell Cluster Services for Linux 
Administration Guide. 


Example For example, at the command prompt, enter the following (all on the same line): 


nlvm create linux volume 
type=ext3 
device=sdf 
mp=/mnt/vol44 
mntopt=rw 
lvm 
name-vol44 
group-vg44 
shared 
ip=10.10.10.44 
ncp 


If the command is successful, the response is 


Linux clustered volume vol44 created. 


4 Verify that the cluster resource was created and brought online by entering 


cluster status 


The resource is named «/v name». resource. In the following example, vol44 resource is in 
the Running state. 
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avalon:-/Desktop # cluster status 


Master IP Address Resource Running avalon 1 
lvmvoli34 resource Running avalon 1 
ol44 resource Running avalon l 


5 Continue with Section 8.4, “Configuring the LVM Cluster Resource Settings,” on page 95. 


8.4 Configuring the LVM Cluster Resource Settings 


Use the procedure in this section to verify that the LVM volume group cluster resource was created 
and is online. You can customize the resource policies, monitoring, and preferred nodes settings. 
1 Open iManager in a web browser, then log in as a cluster administrator user. 
2 In Roles and Tasks, select Clusters > My Clusters. 
3 Select the cluster where you created the volume group cluster resource. 


If the cluster you want to manage is not in the list, you can add it. Click Add, browse to locate and 
select the Cluster object of the cluster, then click OK. 


4 In the list of resources, locate the new resource, such as vol44 resource, and notice the state 
of the resource. It should be online and running. 


My Clusters > clus! .ncs.nove 


& clus1.ncs.novell e 


ts and resources in the cluster. You can also migrate cluster resources to different servers in the cluster, or change the state 


of both s 
offline or online 


f Cluster Manager \ LLEDET US) BCC Manager \ Cluster Event Log \ Cluster Options 
. Run Report | 
Epoch: 0 


B 


avalon 


Online | Offline | Migrate | Respond to Alert | Refresh» 2 Item(s) 
C Type =| Name State Location Lives Up Since 
[ E Master IP Address Resource @ Running avalon 1 Aug 8, 2012 10:01:33 AM 
O 49  vol44 resource @ Running avalon 1 
Close 


5 Click the resource’s name link to open its Properties page. 


You can alternatively go to the Cluster Options page, then click the resource’s name link, or 
select the check box next to the resource and click Details. 
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6 On the Resource Policies page, view and modify the resource's Policy settings if needed. Click 


Apply if you make changes. 


My Clusters > clus .ncs.novell 


æ vol44 resource 


K 


Monitoring \ Preferred Nodes \ Scripts \ Business Continuity 


Set Start, Failover and Failback modes 
resource will not take affect until the re 


ource. Changes other than business continuity changes made to a 


Failover Mode 
CT Resource Follows Master @ Auto 
C Ignore Quorum O Manual 
Start Mode Failback Mode 
(€ Auto © Auto 
2 Manual (€ Disable 
| Manual 
OK | Cancel | Apply | 


6a (Optional) Select the Resource Follows Master check box if you want to ensure that the 
resource runs only on the master node in the cluster. 


If the master node in the cluster fails, the resource fails over to the node that becomes the 
master. 


6b (Optional) Select the /gnore Quorum check box if you don't want the cluster-wide timeout 
period and node number limit enforced. 


The quorum default values were set when you installed Novell Cluster Services. You can 
change the quorum default values by accessing the properties page for the Cluster object. 


Selecting this box ensures that the resource is launched immediately on any server in the 
Assigned Nodes list as soon as any server in the list is brought online. 


6c By default, the Generic File System resource template sets the Start mode and Failover 
mode to Auto and the Failback Mode to Disable. You can change the default settings as 
needed. 


* Start Mode: If the Start mode is set to Auto, the resource automatically loads on a 
designated server when the cluster is first brought up. If the Start mode is set to 
Manual, you can manually start the resource on a specific server when you want, 
instead of having it automatically start when servers in the cluster are brought up. 


* Failover Mode: If the Failover mode is set to Auto, the resource automatically moves 
to the next server in the Assigned Nodes list if there is a hardware or software failure. If 
the Failover mode is set to Manual, you can intervene after a failure occurs and before 
the resource is started on another node. 


* Failback Mode: If the Failback mode is set to Disable, the resource continues running 
on the node it has failed to. If the Failback mode is set to Auto, the resource 
automatically moves back to its preferred node when the preferred node is brought 
back online. Set the Failback mode to Manual to prevent the resource from moving 
back to its preferred node when that node is brought back online, until you are ready to 
allow it to happen. 
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7 Enable and configure monitoring for the resource, then click Apply. 


My Clusters > clus! .ncs.novell ol44 resc 


+ 


vol44 resource 


Policies Preferred Nodes \ Scripts \ Business Continuity 


wi Enable Resource Monitoring 
Polling Interval 1 | Minutes © | 
Failure Rate 


Maximum Local Failures: |3 | 


Time Interval: [10 || Minutes £ | 


(Example: 3 Failures in 5 minutes) 


Failure Action 


Ifthe Failure rate settings are reached, perform the following action 


@  SetResource as Comatose 


Migrate the Resource based on the Preferred Nodes List 


Reboot the Hosting Node without Syncing or Unmounting Disks 


OK | Cancel | Apply | 


7a In the Properties page, select the Monitoring tab. 


7b Select the Enable Resource Monitoring check box to enable resource monitoring for the 


7C 


7d 


7e 


selected resource. 
Resource monitoring is disabled by default. 


Specify the Polling Interval to control how often you want the resource monitor script for this 
resource to run. 


You can specify the value in minutes or seconds. 


Specify the number of failures (Maximum Local Failures) for the specified amount of time 
(Time Interval). 


Specify the Failover Action by indicating whether you want the resource to be set to a 
comatose state, to migrate to another server, or to reboot the hosting node (without 
synchronizing or unmounting the disks) if a failure action initiates. The reboot option is 
normally used only for a mission-critical cluster resource that must remain available. . 
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8 Click the Preferred Nodes tab, assign preferred nodes for the resource by moving them from the 
Unassigned list to the Assigned list, then click Apply. 


When you configure a volume group cluster resource with NSSMU or with NLVM commands, the 
node where you create it is automatically assigned as a preferred node for the resource. 


When you bring a resource online, it is automatically loaded on the most preferred node in the 
list. If the node is not available, the other nodes are tried in the order that they appear in the list. 
You can modify the order of the nodes by clicking the Edit (pen) icon to open the list in a text 
editor. In the editor, click OK to close the editor, then click Apply to save your changes. 


My Clusters > clust.ncs.novell > vol44 | 


# vol44_resource 


Policies \ Monitoring 2/5100 LLL Scripts | Business Continuity 


change the preferred nodes fe s 
e will not take affect until the resource is 


e. Changes other than business continuity changes made to a 


reso 


Assigned Unassigned 


avalon 
london 
cardiff 
newcastle 


Fm A 


OK ] Cancel | Apply | 


9 Atthe bottom of the page, click OK to close the Properties page and save your changes. 
The changes do not take effect until the resource is taken offline and brought online again. 
10 Continue with Section 8.5, "Viewing or Modifying the LVM Resource Scripts,” on page 98. 


85 Viewing or Modifying the LVM Resource Scripts 


You can customize the scripts by adding lines for other products that use a shared LVM volume group 


resource. Compare the generic script with the templates for those products to identify what lines need 
to be added or modified. 


1 In iManager, select Clusters » My Clusters. 
Select the cluster where you created the volume group cluster resource. 


3 Select the cluster resource's name link to open the Properties page, then click the Scripts tab. 
The Scripts tab automatically opens to the load script. 


4 On the Load Script page, view or modify the load script. Click Apply if you make changes. 


Ensure that all letters in the NCP volume name are capitalized letters A to Z. See the “Sample 
LVM Resource Load Scripts Created by NSS Management Tools" on page 101. 
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My Clusters > clus1 .ncs.novell > vold4_resource 


æ vol44 resource [2] 


Policies \ Monitoring \ Preferred Nodes Business Continuity 


Load Script | Unload Script | Monitor Script 


View or edit the load script for this cluster resource. Changes other than business continuity changes made to a resource will 
not take affect until the resource is reloaded 


Script 

MOUNT FS-ext3 

#define the volume group name 
MOLGROUP NAME-vol44 


# define the device 


INCP. SERVER-c lus1 - vol44- SERVER 
# define NCP volume name 
INCP. VOLUME- VOL 44) 


# activate the volume group 


exit on error vgchange -a ey $VOLGROUP NAME 


Timeout: |6 || Minutes € 


OK |  Canel | Apply 


5 Click the Unload Script link to view or modify the unload script. Click Apply if you make changes. 


Ensure that all letters in the NCP volume name are capitalized letters A to Z. See the "Sample 
LVM Resource Unload Scripts Created by NSS Management Tools" on page 102. 


My Clusters > clust .ncs.novell > vol44 resource 
æ vol44 resource [2] 
Policies \ Monitoring \ Preferred Nodes Business Continuity \ 


Load Script | Unload Script | Monitor Script 


View or edit the unload script for this cluster resource. Changes other than business continuity changes made to a resource will 
not take affect until the resource is reloaded. 


Script: 

RESOURCE IP-137.65.67.44 

# define the file system type 

MOUNT. ES-ext3 

#define the volume group name 
IP NAME-vol44 

# define the device 

MOUNT DEV-/dey/vol44/vol44 

# define the mount point 

MOUNT. POINT-/usr/noxell/vol44 

# define NCP server name 

NCP_SERVER=c lus1- vol44- SERVER 

# define NCP volume name 

NÇP_ VOLUME-VOL 44] 


ignore error ncpcon unbind --ncpservername-$NCP SERVER --ipaddress=$! 


Timeout: |6 | [Minutes ©] 


— —OK | Cancel | Apply | 


6 Click the Monitor Script link to view or modify the monitor script. Click Apply if you make 
changes. 


Ensure that all letters in the NCP volume name are capitalized letters A to Z. See the “Sample 
LVM Resource Monitor Scripts Created by NSS Management Tools” on page 103. 
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My Clusters > clus] .ncs.novell 44 resource 


æ Vol44 resource ? 


Policies \ Monitoring \ Preferred Nodes Business Continuity 


Load Script | Unload Script | Monitor Script 


View or edit the monitor script for this cluster resource. Changes other than business continuity changes made to a resource 
will not take affect until the resource is reloaded 

Script 

# define the file system type [^ 


MOUNT_FS=ext3 El 
#define the volume group name 
MOLGROUP NAME-vol44 

# define the device 

MOUNT DEV-/dey/vol44/vol44 

# define the mount point 
MOUNT. POINT-/usr/noyell/vol44 
# define NCP server name 

NCP SERVEReclusl-vol44-SERVER 
# define NCP volume name 
INCP. VOLUME-VOL 44| 


# check the IP address D 
ignore error status secondary ipaddress $RESOURCE IP [v] 


Timeout: |6 | [Minutes € 


OK | Cancel | Apply | 


7 Atthe bottom of the page, click OK to close the Properties page and save your changes. 
The changes do not take effect until the resource is taken offline and brought online again. 


8 If you modified the settings on any of the pages, you must take the resource offline and bring it 
online in order for the changes to take effect. 


8a In Roles and Tasks, select Clusters > My Clusters. 

8b On the Cluster Manager page, select the check box next to the resource, then click Offline. 
Wait for the status to report that it is offline, then continue. 

8c Select the check box next to the resource, then click Online. 

8d Verify that the resource comes online and reports a Running state. 


If the resource goes into a Comatose state, it is probably because you made a mistake in 
the lines you added or modified in the scripts. Take the resource offline, then go back to 
correct the scripts, and try to bring it online again. 


8.6 Sample LVM Resource Scripts 


The sample LVM resource scripts in this section are automatically generated for an LVM volume 
group cluster resource when you use NLVM or NSSMU to create a clustered LVM2 volume, as 
described in Section 8.3, "Configuring an LVM Volume Group Cluster Resource with NSS 
Management Tools," on page 85. See Section 8.3.1, "Sample Values," on page 86 for information 
about the sample values used in these scripts. Ensure that you replace sample values with those for 
your own system. 


+ Section 8.6.1, “Sample LVM Resource Load Scripts Created by NSS Management Tools," on 
page 101 


* Section 8.6.2, “Sample LVM Resource Unload Scripts Created by NSS Management Tools," on 
page 102 


* Section 8.6.3, “Sample LVM Resource Monitor Scripts Created by NSS Management Tools,” on 
page 103 
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8.6.1 


Sample LVM Resource Load Scripts Created by NSS 
Management Tools 


Compare the load scripts in this section to identify the lines that are added when you enable the LVM 


logical volume for NCP file access: 


+ “Without NCP File Access” on page 101 
* “With NCP File Access” on page 101 


Without NCP File Access 


!/bin/bash 
/opt/novell/ncs/lib/ncsfuncs 


define the IP address 

RESOURCE IP-10.10.10.44 

define the file system type 

MOUNT_FS=ext3 

define the volume group name (nssmu uses volume name for group name) 
VOLGROUP_NAME=vol44 

define the device 

MOUNT _DEV=/dev/$VOLGROUP_NAME/vol44 
define the mount point 

MOUNT POINT-/mnt/vol44 


activate the volume group 
exit on error vgchange -a ey $VOLGROUP NAME 


create the mount point if it does not exist on the node 
ignore error mkdir -p $MOUNT POINT 


mount the file system 
exit on error mount fs $MOUNT DEV $MOUNT POINT $MOUNT FS 


add the IP address 
exit on error add secondary ipaddress $RESOURCE IP 


exit 0 


With NCP File Access 


!/bin/bash 
/opt/novell/ncs/lib/ncsfuncs 


define the IP address 
RESOURCE IP-10.10.10.44 

define the file system type 
MOUNT_FS=ext3 

define the volume group name (nssmu uses volume name for group name) 
VOLGROUP NAME-vol144 


define the device 

MOUNT DEV-/dev/$VOLGROUP NAME/vol44 
define the mount point 

MOUNT POINT-/mnt/vol44 


define NCP server name 
NCP_SERVER=clus1-vol44-SERVER 
define NCP volume name 
NCP_VOLUME=VOL44 


activate the volume group 
exit on error vgchange -a ey $VOLGROUP NAME 


create the mount point if it does not exist on the node 
ignore error mkdir -p $MOUNT POINT 
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8.6.2 


mount the file system 
exit on error mount fs $MOUNT DEV $MOUNT POINT $MOUNT FS 


add the IP address 
exit on error add secondary ipaddress $RESOURCE IP 


mount the NCP volume 
exit on error ncpcon mount $NCP VOLUME-251,PATH-$MOUNT POINT 


bind the NCP virtual server to the resource IP address 
exit on error ncpcon bind --ncpservername-$NCP SERVER --ipaddress=$RESOURCE IP 


exit 0 


Sample LVM Resource Unload Scripts Created by NSS 
Management Tools 


Compare the unload scripts in this section to identify the lines that are added when you enable the 
LVM logical volume for NCP file access: 


* "Without NCP File Access" on page 102 
* "With NCP File Access" on page 103 


Without NCP File Access 


!/bin/bash 
/opt/novell/ncs/lib/ncsfuncs 


define the IP address 

RESOURCE IP-10.10.10.44 

define the file system type 

MOUNT_FS=ext3 

define the volume group name (nssmu uses volume name for group name) 
VOLGROUP_NAME=vol44 

define the device 

MOUNT DEV-/dev/$VOLGROUP NAME/vol44 
define the mount point 

MOUNT POINT-/mnt/vol44 


del the IP address 
ignore error del secondary ipaddress $RESOURCE IP 


unmount the volume 
Sleep 10 # if not using SMS for backup, please comment out this line 
exit on error umount fs $MOUNT DEV $MOUNT POINT $MOUNT FS 


deactivate the volume group 
exit on error vgchange -a n $VOLGROUP NAME 


exit 0 
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With NCP File Access 


!/bin/bash 
/opt/novell/ncs/lib/ncsfuncs 


define the IP address 

RESOURCE IP-10.10.10.44 

define the file system type 

MOUNT_FS=ext3 

define the volume group name (nssmu uses volume name for group name) 
VOLGROUP_NAME=vol44 

define the device 

MOUNT DEV-/dev/$VOLGROUP NAME/vol44 
define the mount point 

MOUNT POINT-/mnt/vol44 


define NCP server name 
NCP_SERVER=clus1-vol44-SERVER 
define NCP volume name 
NCP_VOLUME=VOL44 


unbind the NCP virtual server from the resource IP address 
ignore error ncpcon unbind --ncpservername=$NCP SERVER --ipaddress=$RESOURCE_IP 


dismount the NCP volume 
ignore error ncpcon dismount $NCP VOLUME 


del the IP address 
ignore error del secondary ipaddress $RESOURCE IP 


unmount the volume 
Sleep 10 # if not using SMS for backup, please comment out this line 
exit on error umount fs $MOUNT DEV $MOUNT POINT $MOUNT FS 


deactivate the volume group 
exit on error vgchange -a n $VOLGROUP NAME 


exit 0 


8.6.3 Sample LVM Resource Monitor Scripts Created by NSS 
Management Tools 


Compare the monitor scripts in this section to identify the lines that are added when you enable the 
LVM logical volume for NCP file access: 


+ "Without NCP File Access" on page 104 
* "With NCP File Access" on page 104 
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Without NCP File Access 


!/bin/bash 
/opt/novell/ncs/lib/ncsfuncs 


define the IP address 

RESOURCE IP-10.10.10.44 

define the file system type 
MOUNT_FS=ext3 

define the volume group name 
VOLGROUP NAME-vol144 

define the device 

MOUNT DEV-/dev/$VOLGROUP NAME/vol44 
define the mount point 

MOUNT POINT-/mnt/vol44 


check the logical volume 
exit on error status lv $MOUNT DEV 


test the file system 
exit on error status fs $MOUNT DEV $MOUNT POINT $MOUNT FS 


status the IP address 
exit on error status secondary ipaddress S$RESOURCE IP 


exit 0 


With NCP File Access 


!/bin/bash 
/opt/novell/ncs/lib/ncsfuncs 


define the IP address 
RESOURCE IP-10.10.10.44 

define the file system type 
MOUNT_FS=ext3 

define the volume group name 
VOLGROUP_NAME=vol44 

define the device 

MOUNT DEV-/dev/$VOLGROUP NAME/vol44 
define the mount point 

MOUNT POINT-/mnt/vol44 


define NCP server name 
NCP_SERVER=clus1-vol44-SERVER 
define NCP volume name 
NCP_VOLUME=VOL44 


check the LVM logical volume 
exit_on_error status_lv $MOUNT_DEV 


check the NCP volume 
exit on error ncpcon volume $NCP_VOLUME 


check the file system 
exit on error status fs $MOUNT DEV $MOUNT POINT $MOUNT FS 


status the IP address 
exit on error status secondary ipaddress S$RESOURCE IP 


exit 0 
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8.7 


Renaming the Mount Point Path for a Clustered 
LVM Volume 


For a clustered LVM volume, you can rename the mount point path by modifying the mount point 
variable in the cluster load, unload, and monitor scripts. 
1 Open iManager in a web browser, then log in as a cluster administrator user. 


2 In Roles and Tasks, select Clusters > My Clusters, then select the cluster that you want to 
manage. 


If the cluster is not in your personalized list, you can add it. Click Add, browse to locate and 
select the cluster, then click OK. 


3 On the Cluster Manager page, select the check box next to the resource, then click Offline. Wait 
for the status to report that it is offline, then continue. 


4 Modify the mount point path value in the load, unload, and monitor scripts for the LVM volume 
group Cluster resource: 


4a On the Cluster Manager page, select the resource's name link to open its Cluster Properties 
page, then click the Scripts tab. 


The Scripts tab automatically displays the load script. 
4b Modify the load script: 
4b1 In the load script, type the new value for the mount point in the MOUNT POINT 
variable: 
MOUNT_POINT=/media/ext3/vol44 
4b2 Ensure that the following command is added above the mount command line in the 
load script in order to create the path on nodes if it does not exist. 


# create the mount point if it does not exist on the node ignore_error 
mkdir -p SMOUNT_POINT 


You can alternatively make the new path by using the mkdir command in a terminal 
console on each node. If the master node is not the most preferred node, ensure that 
you make the path before you bring the resource online. 


4b3 Click Apply. 

4c Click the Unload Script link, type the new value for the mount point in the MOUNT POINT 
variable, then click Apply. 
MOUNT POINT-/media/ext3/vol44 

4d Click the Monitor Script link, type the new value for the mount point in the MOUNT POINT 
variable, then click Apply. 
MOUNT POINT-/media/ext3/vol44 

4e Atthe bottom of the page, click OK to close the Properties page and save your changes. 
The changes do not take effect until the resource is brought online. 

5 Bring the resource online in order for the script changes to take effect. 
5a In Roles and Tasks, select Clusters > Cluster Manager. 


5b Select the check box next to the resource, then click Online. 
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5c Verify that the resource comes online and reports a Running state. 


If the resource goes into a Comatose state, it is probably because you made a mistake in 
the lines you added or modified in the scripts. Take the resource offline, go back and correct 
the scripts, then try to bring it online again. 


6 In NSSMU, verify that the new mount point is used when the clustered LVM volume resource is 
brought online: 


6a Log in as the root user to the node that is hosting the resource, then start NSSMU by 
entering: 
nssmu 

6b From the NSSMU main menu, select Linux Volumes, then press Enter. 

6c In the Linux Volumes list, select the clustered LVM volume. 

6d View the volume details to verify that the mount point has changed. 
For example, the mount point is /media/ext3/vol44. 


media/ext 


Er | 


Sharable for ¢ 


ESC-Exit 


Ins-Create Del=Delete F3=Rename FS=Refresh F7=Mount/Dismount 


6e Press Esc twice to exit NSSMU. 


8.8 Renaming a Clustered LVM Logical Volume 


For a clustered LVM logical volume, there is no easy tool for renaming the volume. You can rename 
the LVM logical volume by using the 1vrename command, then modify the volume name in the cluster 
load, unload, and monitor scripts. The command does not change the volume group name. The LVM 
cluster resource must be offline while you rename the logical volume and modify the scripts. 


Using the 1vrename command to rename the LVM logical volume does not modify other related 
parameters that are used by the LVM cluster resource. You can optionally also modify the following: 
* Mount point path 
* Resource name 
* If NCP is enabled for the LVM logical volume: 
* NCP virtual server name 
* NCP volume name 
* Volume object for the NCP volume on the virtual server 
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Take the resource offline, modify the related parameters, modify the resource scripts with the new 
values, then bring the resource online. 
1 Log in to the server as the root user, then open a terminal console. 


2 Bring the LVM cluster resource offline. 


cluster offline <lvm_resource_name> 


For example, to offline the vol44_resource, enter 


cluster offline vol44 resource 


Wait until the resource is offline before continuing. 


3 At the command prompt, enter 
lvrename «/dev/vg name/old lv name» «/dev/vg name/new lv name» 


Replace vg name with the name of the volume group. If you created the L VM logical volume in 
NSSMU, the volume group name is the same as the logical volume name. If you created the 
LVM logical volume with NLVM or with LVM commands, you might have used a different name 
for the volume group. 


Replace old lv name with the current name of the LVM logical volume. 

Replace new lv name with the new name of the LVM logical volume. 

For example, to change the name of the logical volume on volume group vghome from 1v users 
to 1v home, enter 


lvrename /dev/vghome/lv users /dev/vghome/lv home 


4 Modify the load, unload, and monitor scripts for the LVM cluster resource to use the new LVM 
logical volume name in the value for the MOUNT DEV parameter. 


4a Open iManager in a web browser, then log in as a cluster administrator user. 


4b In Roles and Tasks, select Clusters > My Clusters, then select the cluster where you 
created the LVM cluster resource. 


4c On the Cluster Manager page, select the check box next to the resource, then click Offline. 
Wait for the status to report that it is offline, then continue. 


4d Modify the MOUNT DEV value in the load, unload, and monitor scripts for the LVM volume 
group cluster resource: 


4d1 On the Cluster Manager page, select the resource's name link to open its Cluster 
Properties page, then click the Scripts tab. 


The Scripts tab automatically displays the load script. 

4d2 Modify the load script: 
In the load script, type the new value for the logical volume in the MOUNT DEV 
variable, then click Apply. 


# define the device 
MOUNT DEV-/dev/$VOLGROUP NAME/lv home 


4d3 Click the Unload Script link, type the new value for the logical volume in the 
MOUNT DEV variable, then click Apply. 


# define the device 
MOUNT DEV- /dev/ $VOLGROUP NAME / lv home 


4d4 Click the Monitor Script link, type the new value for the logical volume in the 
MOUNT DEV variable, then click Apply. 
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# define the device 
MOUNT DEV-/dev/$VOLGROUP NAME/lv home 


4d5 Atthe bottom of the page, click OK to close the Properties page and save your 
changes. 
The changes do not take effect until the resource is brought online. 


5 (Optional) Rename the mount point path that you use for the logical volume. The mount point 
should still be unmounted when you perform this task. 


For information, see “Renaming the Mount Point Path for a Clustered LVM Volume" in the OES 
11 SP3: Novell Cluster Services for Linux Administration Guide. 


6 (Optional) Rename the resource. 


Ensure that the resource is offline, then enter 


cluster rename «old resource name» «new resource name» 


7 (Optional) If you created an NCP virtual server for the resource, rename the NCP virtual server 
name. 


Use the Directory Administration » Delete Object task in iManager to delete the old NCP virtual 
server (the NCS:NCP Server object) for the resource, then use /opt/novell/ncs/bin/ 

ncs ncpserv.py to create a new virtual server for the resource. For information, see "Creating a 
Virtual Server Object for an LVM Volume Group Cluster Resource" in the OES 11 SP3: Novell 
Cluster Services for Linux Administration Guide. Ensure that you update the load, unload, and 
monitor scripts. 


8 (Optional) If NCP file access is enabled for the LVM logical volume, rename the NCP volume and 
its Volume object. 


8a Modify the NCP volume name for the NCP VOLUME parameter in the load, unload, and 
monitor scripts for the LVM cluster resource. For information, see “Adding NCP Volume 
Commands to the Resource Scripts" in the OES 11 SP3: Novell Cluster Services for Linux 
Administration Guide. Bring the resource online, but do not allow users to access the 
volume until the Volume object is re-created. 


8b Use the Directory Administration » Delete Object task in iManager to delete the old Volume 
object, then create a new Volume object that uses the newly created NCP virtual server 
name and new NCP volume name. For information, see "Creating a Shared NCP Volume 
Object” in the OES 11 SP3: Novell Cluster Services for Linux Administration Guide. 


9 Bring the resource online. At the command prompt, enter 


cluster online «resource name» 


8.9 Disabling Clustering for an LVM Volume 


Use the procedure in this section if you want to disable clustering for an LVM volume. Afterward, you 
can mount and dismount the volume only as a local LVM volume. 
1 Delete the LVM volume group cluster resource: 
1a Open iManager in a web browser, then log in as a cluster administrator user. 


1b In Roles and Tasks, select Clusters » My Clusters, then select the cluster that you want to 
manage. 


If the cluster is not in your personalized list, you can add it. Click Add, browse to locate and 
select the cluster, then click OK. 
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1c On the Cluster Manager page, select the check box next to the LVM volume group cluster 
resource (such as vol44 resource), then click Offline. Wait until the resource is offline to 
continue. 


1d Select Clusters » Cluster Options. 


1e On the Cluster Options page, select the check box next to the LVM volume group cluster 
resource, click Delete, then click OK to confirm. 


1f Exit iManager. 


2 Login as the root user on the server where the resource was online, then open a terminal 
console. 


3 Remove the shareable state from the clustered LVM volume group by entering 
vgchange -c n «vg name» 


For example: 


vgchange -c n vol44 
4 Activate the volume group on the current node by entering 
vgchange -a ey «vg name» 
For example: 
vgchange -a ey vol44 
5 Mount the LVM logical volume by entering 


mount -t «fstype» «device name» «full mount point path» 


Replace fstype with the file system type of the volume. 


Replace device name with the full device path of the logical volume, such as /dev/«vg name»! 
«lv name». 


Replace full mount point path with the volume's mount point. 
For example, enter 


mount -t ext3 /dev/vol44/vol44 /media/ext3/vol44 


6 In a text editor, modify the /etc/fstab file to specify the mount point information and file system 
type. 


This entry allows the volume to be mounted automatically on reboot. It also provides the 
automatic mount information for NSSMU to use to mount and dismount the volume locally. 


For example, complete the line for the volume's device path, such as: 
/dev/vol44/vol44 /media/ext3/vol44 ext3 rw 0 0 


“fstab (/etc) - gedit 


File Edit View Search Tools Documents Help 


[] Bop v sa & À uno Bt 

E] “fstab X 

/dev/sda2 swap swap defaults 00 | 
/dev/sda3 / ext3 acl,user_xattr 11 
/dev/sdal /boot ext2 acl,user xattr 12 | 
proc /proc proc defaults 00 
sysfs /sys sysfs noauto o0 
debugfs /sys/kernel/debug debugfs noauto 00 
usbfs /proc/bus/usb usbfs noauto 00 
devpts /dev/pts devpts mode=0620, gid-5 00 
/dev/vg44/vol44 /mnt/vol44 ext3 rw oq 
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7 In NSSMU, go to the Linux Volumes page, then select the volume to view its details. 


The volume is no longer cluster enabled. You can mount and dismount the volume only on the 
current node. 


í lusterinc 


Ins=Create Del=Delete F3=Rename FS=Refresh F7=Mount/Dismount  ESC=Exit 


8.10 Deleting a Clustered LVM Volume Group and 
Logical Volume 


Before you delete a clustered LVM volume group, you must take the volume group cluster resource 
offline, and delete the cluster resource object and related objects in eDirectory. 


All resource configuration must happen from the master node. On the Cluster Options page for 
iManager, you are automatically connected to the Cluster object, which is associated with the master 
node. 


1 Log in to iManager as a cluster administrator. 
2 In Roles and Tasks, select Clusters > My Clusters, then select the cluster. 
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3 Take the volume group cluster resource offline: 


3a On the Cluster Manager page, select the check box next to the volume group cluster 


resource, then click Offline. Wait until the resource is offline to continue. 


My Clusters > clusi .ncs.novell 


$* clus1.ncs.novell [2] 


View the status of both servers and resources in the cluster. You can also migrate cluster resources to different servers in the cluster, or change the state 
of resources to offline or online 


f cluster Manager \ ETE TS) BCC Manager \ Cluster Event Log \ Cluster Options | 
Run Report 

Epoch: 0 

avalon 


Cluster State 


Online | Offline | Migrate | Respondto Alert | Refresh» 2 Item(s) 
LI Type [F| Name State Location Lives Up Since 
4 Master IP Address Resource @ Running avalon 1 Aug 8, 2012 10:01:33 AM 
D 4 Vol44 resource (==) Offline 1 
Close 


The unload script unbinds the NCP virtual server from the resource IP address, dismounts 
the NCP volume, dismounts the Linux LVM logical volume, and deactivates the Linux LVM 


volume group. 


4 Delete the volume group cluster resource: 
4a Click the Cluster Options tab. 


4b 


4c 


Select the check box next to the volume group cluster resource, then click Delete. 


My Clusters > clus1 nes novell 


$* clus1.ncs.novell 


View cluster resource configuration information and administer cluster resources for the selected cluster 


E 
Cluster Manager | BCC Manager | Cluster Event Log F Cluster Options Y 
. Properties... | 


Cluster Objects 
New | Delete | Details 


15 Item(s) 
C Ime E Name. IP Address Distinguished Name Pool Name 
[] @ Master IP Address Resource 10.10.10.134 — cn=clust.ou=ncs,o=novell 
D] ® © avalon 10.10.10.37 —— cncavalon,cneclust ,ou=ncs,o=novell 
M Ææ vais resource 
O 4  vola2 resource 


When you are prompted to confirm the deletion, click OK to continue, or click Cancel to 
abort the deletion. 


| 
Are you sure you want to delete the selected resource(s)? 
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5 If the Linux volume was enabled for NCP file access, delete the NCP volume object. 
5a In iManager, select Directory Administration > Delete Object. 
5b On the Delete Object page, browse to locate and select the resource’s NCP Volume object 
(such as clus1i VOL44.novell) then click OK. 


@ Delete Object 
Specify the object(s) to delete. 


Select a single object | Select multiple objects | Simple Selection | Advanced Selection 


Object name 
clus1_VOL44 novell 


OK Cancel 


5c Click OK to delete the NCP volume object, then click OK again to close the success 
message. 


6 If the Linux volume was NCP enabled, or if you manually created an NCP virtual server for the 
resource, delete the NCP virtual server object. 


6a In iManager, select Directory Administration > Delete Object. 
6b On the Delete Object page, browse to locate and select the resource’s NCS:NCP Server 
object (such as c1us1-vg44-SERVER.ncs .novell), then click OK. 


@ Delete Object 
Specify the object(s) to delete 


Select a single object | Select multiple objects | Simple Selection | Advanced Selection 


Object name 
| clus-vg44-SERVER. ncs.novell 


OK Cancel 


6c Click OK to delete the NCP virtual server, then click OK again to close the success 
message. 


7 Delete the LVM volume group and logical volume: 


7a Log in as the root user to the cluster node where the resource was online, then open a 
terminal console. 


7b Ata command prompt, launch NSSMU: 
nssmu 


7c Inthe NSSMU main menu, select Linux Volumes, then press Enter. 


7d In the Linux Volumes list, select the clustered linux volume, then press Delete. 
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 F7-Mount/Dismount 


7e When you are prompted to confirm the delete action, press y (Yes) to continue, or press n 
(No) to cancel the delete action. 
Deleting the volume and volume group puts the device in an uninitialized state. 
7f Press Esc to return to the main menu. 
8 Re-initialize the device: 
8a In the NSSMU main menu, select Devices, then press Enter. 
8b In the Devices list, select the device. 


Device Intormatio 
sdf 
Uninitialized 


No 


No 


Sharable for Clustering: No 


Fs=init F5=Refresh F6=Share SPACE=Select/Unselect — 


8c Press F3 to initialize the device. 
8d When you are prompted to confirm the initialization action, read the warning message, then 
press y (Yes) to continue, or press n (No) to cancel the action. 


8e Select DOS or GPT as the partitioning type, then press Enter. 
8f Visually verify that the device was initialized and the specified partition type is displayed. 


8g Press Esc twice to exit NSSMU. 
9 Verify that the LVM volume group is deleted by entering the following the native LVM command: 


vgdisplay 
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8.11 Deleting a Clustered LVM Volume (Created in 
NSSMU or NLVM) 


We strongly recommend that you delete a cluster-enabled LVM volume only from the master node in 
the cluster. This allows the cluster information to be automatically updated. 


The procedures in this section assume that you created the clustered LVM volume in NSSMU or 
NLVM. There are default naming conventions applied by these tools that might not apply to LVM 
volume groups that you created and cluster-enabled by using native LVM tools and the Generic File 
System template. 


WARNING: Deleting an LVM volume destroys all data on it. 


NSSMU and the nlvm delete linux volume <volume_name> command delete the cluster-enabled 
LVM volume as well as the related objects in eDirectory: 


+ Linux LVM volume group and logical volume from the file system 
* Cluster Resource object for the LVM resource 
+ If the LVM volume is NCP-enabled: 

* Volume object for the LVM volume 

¢ Virtual server for the LVM resource (NCS:NCP Server object) 


When the LVM volume resides on the master node, the cluster information is automatically updated. 


When the LVM volume resides on a non-master node, additional steps are required to update the 
cluster information. A cluster restart might be needed to force the information to be updated. 


Use the following procedures to delete a cluster-enabled LVM volume: 


+ Section 8.11.1, “Deleting a Cluster-Enabled LVM Volume on the Master Node,” on page 114 
+ Section 8.11.2, “Deleting a Cluster-Enabled LVM Volume on a Non-Master Node,” on page 115 


8.1.1  Deleting a Cluster-Enabled LVM Volume on the Master Node 


1 If the LVM resource is on a non-master node in the cluster, migrate it to the master node. As the 
root User, open a terminal console, then enter 


cluster migrate «resource name» «master node name» 
To migrate the resource, the master node must be in the resource's preferred nodes list. 


2 Usethe cluster status command to check the resource status. If the resource is online or 
comatose, take it offline. 


As the root user, enter 


cluster offline «resource name» 


Use the cluster status command to verify that the resource has a status of Offline before you 
continue. 
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3 Delete the LVM volume on the master node by using NSSMU. 
You can alternatively use the nlvm delete linux volume «1x volume name» command. 
3a In NSSMU, select Linux Volumes, then press Enter. 
3b Select the unmounted LVM volume, then press Delete. 
3c Select OK to confirm, then press Enter. 
4 Inthe Tree View in iManager, browse the objects to verify that the following objects were deleted: 
* LVM resource object (from the Cluster container) 
+ |f the LVM volume was NCP-enabled: 
+ Volume object for the LVM volume 
¢ Virtual server for the LVM resource (NCS:NCP Server object) 
5 Re-initialize the device that contained the LVM volume. 


When NLVM or NSSMU removes the Linux LVM volume group, it leaves the device in an 
uninitialized state. 


5a In NSSMU, select Devices, then press Enter. 

5b Select the device, then press F3 (Initialize). 

5c Press y (Yes) to confirm. 

5d Select the partitioning scheme as DOS or GPT, then press Enter. 


6 (Optional) Use a third-party SAN management tool to assign the device to only one desired 
server. 


8.11.2 Deleting a Cluster-Enabled LVM Volume on a Non-Master 
Node 


1 Login as the root user to the non-master node where the cluster resource currently resides, 
then open a terminal console. 


2 Usethe cluster status command to check the resource status. If the resource is online or 
comatose, take it offline by using one of the following methods: 


cluster offline «resource name» 


Use the cluster status command to verify that the resource has a status of Offline before you 
continue. 


3 Atthe command prompt on the non-master node, enter 
/opt/novell/ncs/bin/ncs-configd.py -init 


4 Look at the file /var/opt/novell/ncs/resource-priority.conf to verify that it has the same 
information (REVISION and NUMRESOURCES) as the file on the master node. 


5 Delete the LVM volume on the master node by using NSSMU. 
You can alternatively use the nlvm delete linux volume «1x volume name» command. 
5a In NSSMU, select Linux Volumes, then press Enter. 
5b Select the unmounted LVM volume, then press Delete. 
5c Select OK to confirm, then press Enter. 
6 In the Tree View in iManager, browse the objects to verify that the following objects were deleted: 


* LVM resource object (from the Cluster container) 
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+ Ifthe LVM volume was NCP-enabled: 
+ Volume object for the LVM volume 
¢ Virtual server for the LVM resource (NCS:NCP Server object) 
Re-initialize the device that contained the LVM volume. 


When NLVM or NSSMU removes the Linux LVM volume group, it leaves the device in an 
uninitialized state. 


7a In NSSMU, select Devices, then press Enter. 

7b Select the device, then press F3 (Initialize). 

7c Press y (Yes) to confirm. 

7d Select the partitioning scheme as DOS or GPT, then press Enter. 
On the master node, log in as the root user, open a terminal console, then enter 


/opt/novell/ncs/bin/ncs-configd.py -init 


Look at the file /var/opt /novell/ncs/resource-priority.conf to verify that it has the same 
information (REVISION and NUMRESOURCES) as that of the non-master node where you 
deleted the cluster resource. 


In iManager, select Clusters > My Clusters, select the cluster, then select the Cluster Options 
tab. 


Click Properties, select the Priorities tab, then click Apply on the Priorities page. 


At a command prompt, enter 


cluster view 
The cluster view should be consistent. 


Look at the file /var/opt/novell/ncs/resource-priority.conf on the master node to verify 
that the revision number increased. 


If the revision number increased, skip Step 14. 


If the deleted resource is the only one in the cluster, the priority won't force the update. A 
phantom resource might appear in the interface. You need to restart Cluster Services to force the 
update, which also removes the phantom resource. 


If the revision number did not automatically update in the previous steps, restart Novell Cluster 
Services by entering the following on one node in the cluster: 


cluster restart [seconds] 

For seconds, specify a value of 60 seconds or more. 
For example: 

cluster restart 120 


(Optional) Use a third-party SAN management tool to assign the devices to only the desired 
server. 
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Backing Up Linux POSIX Volumes 


Backup of Linux POSIX file systems requires that ACLS and POSIX permissions be set on the Linux 
path for the Linux User Management (LUM) enabled user performing the backup. The root user has 
all permissions needed to perform backup of any Linux path. You can use the Linux chmod (8) and 
chown(8) commands to give the backup user the Linux POSIX permissions to the directory being 
backed up. 


The root user can back up any path in the Linux POSIX filesystem directory. For example, to use the 
nbackup command for Novell Storage Management Services to back up the data in path /usr/ 
novell/ncpvol2/Data/test*, enter 


nbackup -cvf ncptest.sidf -Uroot -Pnovell /usr/novell/ncpvol2/Data/test* 


For information about the nbackup command options, see "nbackup(1)" in the OES 11 SP3: Storage 
Management Services Administration Guide for Linux. 


For information about third-party products that support backup on Novell Open Enterprise Server, go 
to the Open Enterprise Server Partners website (http://www.novell.com/products/ 
openenterpriseserver/partners.html), then select Backup in the Product Type list. 
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A.1 


A.1.1 


Documentation Updates 


This section contains information about documentation content changes made to the Novell Linux 
POSIX Volumes Administration Guide since the initial release of Novell Open Enterprise Server 
(OES) 11. 


This document was updated on the following dates: 


+ Section A.1, "January 2014 (OES 11 SP2),” on page 119 
+ Section A.2, “August 2012 (OES 11 SP1),” on page 121 


January 2014 (OES 11 SP2) 


The guide has been updated with product branding consistent with the current release. Updates were 
made to the following sections. The changes are described below. 

+ Section A.1.1, “Clustering LVM Volume Groups with Novell Cluster Services,” on page 119 

¢ Section A.1.2, “Managing Linux Volumes with NLVM Commands,” on page 120 

+ Section A.1.3, “Managing Linux Volumes with NSSMU," on page 120 

* Section A.1.4, "Overview of Linux POSIX File Systems," on page 120 

+ Section A.1.5, "Planning for Linux POSIX Volumes," on page 121 

* Section A.1.6, "What's New or Changed for Linux POSIX Volumes," on page 121 


Clustering LVM Volume Groups with Novell Cluster Services 


Location Change 
Section 8.3.2, "Creating an LVM Volume Group If you enable NCP for the volume, the LVM volume 
Cluster Resource with NSSMU,” on page 87 name must comply with the limitations for NCP volume 


names described in Section 5.4, "Naming Conventions 
for NCP Volume Names," on page 31. If you use 
lowercase letters for the volume name, they are 
automatically changed to uppercase for the NCP 
volume name. 


Section 8.3.3, "Creating an LVM Volume Group 
Cluster Resource with NLVM Commands," on page 92 


You can specify an unshared initialized device, a 
shared device with no data partitions, or an 
uninitialized device. 


Section 8.11, “Deleting a Clustered LVM Volume This section is new. 
(Created in NSSMU or NLVM),” on page 114 
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A.1.2 


A.1.3 


A.1.4 


Managing Linux Volumes with NLVM Commands 


Location 


Section 7.7, “Creating a Non-LVM Linux Volume,” on 
page 67 


Section 7.8, “Creating an LVM Logical Volume,” on 
page 68 


Change 


If you enable NCP for the volume, the volume name 
must comply with the limitations for NCP volume 
names described in Section 5.4, “Naming Conventions 
for NCP Volume Names,” on page 31. If you use 
lowercase letters for the volume name, they are 
automatically changed to uppercase for the NCP 
volume name. 


Section 7.10, “Mounting Linux Volumes,” on page 70 


The nlvm linux mount command allows you to 
mount a Linux volume in Linux and NCP with a single 
command. 


Section 7.11, “Dismounting Linux Volumes,” on 
page 72 


The nlvm linux unmount command allows you to 
dismount a Linux volume from NCP and Linux with a 
single command. 


Managing Linux Volumes with NSSMU 


Location 


Section 6.9, “Creating a Non-LVM Linux Volume,” on 
page 44 


Section 6.10, “Creating an LVM Logical Volume,” on 
page 48 


Change 


If you enable NCP for the volume, the volume name 
must comply with the limitations for NCP volume 
names described in Section 5.4, “Naming Conventions 
for NCP Volume Names,” on page 31. If you use 
lowercase letters for the volume name, they are 
automatically changed to uppercase for the NCP 
volume name. 


Section 6.12, “Mounting a Linux Volume,” on page 53 


This section is new. 


Section 6.13, “Dismounting a Linux Volume,” on 
page 53 


This section is new. 


Overview of Linux POSIX File Systems 


Location 


“Default Ext3 Inode Size” on page 12 


Change 


To allow space for extended attributes and ACLs for a 
file on Ext3 file systems, the default inode size for Ext3 
was increased from 128 bytes on SLES 10 to 256 
bytes on SLES 11. 
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A.1.5 Planning for Linux POSIX Volumes 


Location Change 
Section 5.2, “Using RAID Devices for Linux POSIX We recommend that you do not use Linux software 
Volumes,” on page 29 RAIDs (such as MD RAIDs and Device Mapper 


RAIDs) for devices that you plan to use for storage 
objects that are managed by NSS management tools. 
The Novell Linux Volume Manager (NLVM) utility and 
the NSS Management Utility (NSSMU) list Linux 
software RAID devices that you have created by using 
Linux tools. Beginning with Linux Kernel 3.0 in OES 11 
SP1, NLVM and NSSMU can see these devices, 
initialize them, and allow you to create storage objects 
on them. However, this capability has not yet been fully 
tested. 


IMPORTANT: In OES 11, a server hang or crash can 
occur if you attempt to use a Linux software RAID 
when you create storage objects that are managed by 
NSS management tools. 


A.1.6 What's New or Changed for Linux POSIX Volumes 


Location Change 


Section 2.2, "What's New (OES 11 SP2),” on page 17 This section is new. 


A.2 August 2012 (OES 11 SP1) 


Updates were made to the following sections. The changes are described below. 


+ Section A.2.1, "Backing Up Linux POSIX Volumes,” on page 121 
* Section A.2.2, “Clustering LVM Volume Groups with Novell Cluster Services," on page 122 


* Section A.2.3, "Installing or Upgrading NSS Management Tools and Linux POSIX File Systems," 
on page 122 


+ Section A.2.4, "Managing Linux POSIX Volumes with NLVM Commands," on page 122 
¢ Section A.2.5, "Managing Linux POSIX Volumes with NSSMU,” on page 122 

+ Section A.2.6, "Planning for Linux POSIX Volumes," on page 122 

+ Section A.2.7, "Using NLVM and NSSMU in a Virtualized Environment,” on page 123 


A.2.1 Backing Up Linux POSIX Volumes 


The Chapter 9, "Backing Up Linux POSIX Volumes," on page 117 section is new. 
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A.2.2 


A.2.3 


A.2.4 


A.2.5 


A.2.6 


Clustering LVM Volume Groups with Novell Cluster Services 


Location 


Section 8.3, “Configuring an LVM Volume Group 
Cluster Resource with NSS Management Tools,” on 
page 85 


Change 


Use the NCP option to enable the Linux POSIX 
volume to be accessed with the NetWare Core 
Protocol (NCP). 


Section 8.8, “Renaming a Clustered LVM Logical 
Volume,” on page 106 


This section is new. 


Installing or Upgrading NSS Management Tools and Linux 


POSIX File Systems 


The Chapter 3, “Installing or Upgrading NSS Management Tools and Linux POSIX File Systems,” on 


page 25 section is new. 


Managing Linux POSIX Volumes with NLVM Commands 


Location 


Section 7.8, “Creating an LVM Logical Volume,” on 
page 68 


Change 


Multiplier can also be T (terabytes). The default 
multiplier is G (gigabytes). 


Section 7.7, “Creating a Non-LVM Linux Volume,” on 
page 67 


Section 7.8, “Creating an LVM Logical Volume,” on 
page 68 


Use the NCP option to enable the Linux POSIX 
volume to be accessed with the NetWare Core 
Protocol. 


Managing Linux POSIX Volumes with NSSMU 


Location 


Section 6.9, “Creating a Non-LVM Linux Volume,” on 
page 44 


Section 6.10, “Creating an LVM Logical Volume,” on 
page 48 


Change 


Use the NCP option to enable the Linux POSIX 
volume to be accessed with the NetWare Core 
Protocol (NCP). 


Section 6.14, “Renaming the Mount Point Path for a 
Linux Volume,” on page 53 


This section is new. 


Section 6.15, “Renaming a Non-LVM Linux Volume,” 
on page 55 


This section is new. 


Section 6.16, “Renaming an LVM Volume,” on page 55 This section is new. 


Planning for Linux POSIX Volumes 


The Chapter 5, “Planning for Linux POSIX Volumes,” on page 29 section is new. 
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A.2.7 Using NLVM and NSSMU in a Virtualized Environment 


The Chapter 4, "Using NLVM and NSSMU in a Virtualized Environment," on page 27 section is new. 
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